Claves API

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

Listar las claves API

GET /api/apikeys/{tenant}

Autenticación: Sesión de un administrador de exoCortex Core

Parámetros

Nombre	Dónde	Tipo	Obligatorio	Descripción
tenant	ruta	string	sí	Tenant code (case-insensitive).

Respuestas

Estado	Descripción
200	Keys of the tenant (secrets are never returned).
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).

Ejemplo 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"
    }
  ]
}

Ejemplo con curl

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

Crear una clave API

POST /api/apikeys/{tenant}

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

Autenticación: Sesión de un administrador de exoCortex Core

Parámetros

Nombre	Dónde	Tipo	Obligatorio	Descripción
tenant	ruta	string	sí	Tenant code (case-insensitive).

Cuerpo de la solicitud

application/json

Nombre	Tipo	Obligatorio	Descripción
name	string	no
scopes	array<string (tickets:create, tickets:read, tickets:comment, tickets:*, *)>	no	Scopes granted to the key. An empty list grants every v1 scope; prefer explicit scopes.

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

Respuestas

Estado	Descripción
200	Key created.
400	Invalid request.
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).

Ejemplo 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."
}

Ejemplo con 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"]}'

Revocar una clave API

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

Autenticación: Sesión de un administrador de exoCortex Core

Parámetros

Nombre	Dónde	Tipo	Obligatorio	Descripción
tenant	ruta	string	sí	Tenant code (case-insensitive).
keyid	ruta	string	sí

Respuestas

Estado	Descripción
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.

Ejemplo 200

{
  "ok": true
}

Ejemplo con curl

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

Página generada a partir de la especificación OpenAPI de la API de integración, versión 1.1.0.