Skip to main content
POST
/
v1
/
api-keys
Crear una API Key
curl --request POST \
  --url https://agents.studio.getsupervisor.ai/v1/api-keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "name": "QA Sandbox",
  "description": "Suite de tests automáticos",
  "environment": "sandbox",
  "scopes": [
    "agents:read",
    "api-keys:read"
  ]
}
'
{
  "id": "d6ef8c66-3c3d-4a87-9edf-9ec5fa929a9c",
  "name": "Backend Integration",
  "description": "Servicio interno para métricas",
  "environment": "production",
  "scopes": [
    "agents:read",
    "workspaces:read"
  ],
  "keyPreview": "sk_live_d6ef...29a9",
  "createdAt": "2025-10-15T15:22:00.000Z",
  "updatedAt": "2025-10-15T15:22:00.000Z",
  "lastUsedAt": null,
  "key": "sk_live_d6ef8c66-3c3d-4a87-9edf-9ec5fa929a9c"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-workspace-id
string<uuid>
required

Identificador del workspace multi-tenant.

Body

application/json
​
name
string
required
Required string length: 1 - 120
​
description
string | null
Maximum string length: 255
​
environment
enum<string>
Available options:
production,
sandbox,
staging,
development
​
scopes
string[]
Minimum array length: 1
Maximum string length: 64

Response

API Key creada con éxito

​
id
string<uuid>
required
​
name
string
required
​
scopes
string[]
required

Lista de scopes autorizados para esta credencial.

Minimum array length: 1
​
environment
enum<string>
required
Available options:
production,
sandbox,
staging,
development
​
keyPreview
string
required

Prefijo y sufijo visibles de la API Key (el valor completo no se expone después de la creación).

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
key
string
required

Valor completo de la API Key. Solo se entrega una vez y debe almacenarse de forma segura.

​
description
string | null
Maximum string length: 255
​
lastUsedAt
string<date-time> | null

Fecha/hora del último uso registrado.

​
revokedAt
string<date-time> | null

Fecha/hora en que se revocó la credencial (si aplica).