Chiavi API

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

Elencare le chiavi API

GET /api/apikeys/{tenant}

Autenticazione: Sessione di un amministratore di exoCortex Core

Parametri

Nome	Dove	Tipo	Obbligatorio	Descrizione
tenant	percorso	string	sì	Tenant code (case-insensitive).

Risposte

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

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

Esempio con curl

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

Creare una chiave API

POST /api/apikeys/{tenant}

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

Autenticazione: Sessione di un amministratore di exoCortex Core

Parametri

Nome	Dove	Tipo	Obbligatorio	Descrizione
tenant	percorso	string	sì	Tenant code (case-insensitive).

Corpo della richiesta

application/json

Nome	Tipo	Obbligatorio	Descrizione
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"
  ]
}

Risposte

Stato	Descrizione
200	Key created.
400	Invalid request.
401	Not authenticated.
403	Authenticated but not allowed (role, tenant or key).

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

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

Revocare una chiave API

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

Autenticazione: Sessione di un amministratore di exoCortex Core

Parametri

Nome	Dove	Tipo	Obbligatorio	Descrizione
tenant	percorso	string	sì	Tenant code (case-insensitive).
keyid	percorso	string	sì

Risposte

Stato	Descrizione
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.

Esempio 200

{
  "ok": true
}

Esempio con curl

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

Pagina generata dalla specifica OpenAPI dell’API di integrazione, versione 1.1.0.