Ключі API

Create, list and revoke tenant-bound API keys (administrator session).

Список ключів API

GET /api/apikeys/{tenant}

Автентифікація: Сесія адміністратора exoCortex Core

Параметри

Назва	Де	Тип	Обов’язковий	Опис
tenant	шлях	string	так	Tenant code (case-insensitive).

Відповіді

Статус	Опис
200	Keys of the tenant (secrets are never returned).
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).

Приклад 200

{
  "ok": true,
  "keys": [
    {
      "keyid": "9f2c4e1a7b3d",
      "name": "ERP connector",
      "scopes": [
        "tickets:create",
        "tickets:read"
      ],
      "active": true,
      "created_at": "2026-11-01T08:00:00.000Z",
      "last_used_at": "2026-11-01T09:14:05.000Z"
    }
  ]
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/api/apikeys/ACME" \
  -H "Authorization: Bearer $EXO_ADMIN_SESSION"

Створити ключ API

POST /api/apikeys/{tenant}

Returns the full key once. exoCortex stores only a hash of the secret.

Автентифікація: Сесія адміністратора exoCortex Core

Параметри

Назва	Де	Тип	Обов’язковий	Опис
tenant	шлях	string	так	Tenant code (case-insensitive).

Тіло запиту

application/json

Назва	Тип	Обов’язковий	Опис
name	string	ні
scopes	array<string (tickets:create, tickets:read, tickets:comment, tickets:*, *)>	ні	Scopes granted to the key. An empty list grants every v1 scope; prefer explicit scopes.

{
  "name": "ERP connector",
  "scopes": [
    "tickets:create",
    "tickets:read"
  ]
}

Відповіді

Статус	Опис
200	Key created.
400	Invalid request.
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).

Приклад 200

{
  "ok": true,
  "key": "nhk.9f2c4e1a7b3d.0123456789abcdef0123456789abcdef0123456789abcdef",
  "keyid": "9f2c4e1a7b3d",
  "name": "ERP connector",
  "scopes": [
    "tickets:create",
    "tickets:read"
  ],
  "note": "Copia la chiave ora: non sarà più mostrata."
}

Приклад із curl

curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/apikeys/ACME" \
  -H "Authorization: Bearer $EXO_ADMIN_SESSION" \
  -H "Content-Type: application/json" \
  --data '{"name":"ERP connector","scopes":["tickets:create","tickets:read"]}'

Відкликати ключ API

DELETE /api/apikeys/{tenant}/{keyid}

Автентифікація: Сесія адміністратора exoCortex Core

Параметри

Назва	Де	Тип	Обов’язковий	Опис
tenant	шлях	string	так	Tenant code (case-insensitive).
keyid	шлях	string	так

Відповіді

Статус	Опис
200	Key revoked. It stops working immediately.
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).
404	Resource not found or not configured.

Приклад 200

{
  "ok": true
}

Приклад із curl

curl -X DELETE "https://exocortex-api.ai-exo-cortex.com/api/apikeys/ACME/9f2c4e1a7b3d" \
  -H "Authorization: Bearer $EXO_ADMIN_SESSION"

Сторінку згенеровано зі специфікації OpenAPI API інтеграції, версія 1.1.0.