Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt

Use this file to discover all available pages before exploring further.

Las API keys se gestionan desde el admin API, autenticada con JWT (no con X-API-Key).
Estos endpoints los utilizan los admins de la empresa desde el dashboard o desde herramientas internas. No uses X-API-Key aquí — usa un token JWT obtenido con credenciales de admin.

​
Restricciones

  • Máximo 5 keys activas por empresa.
  • El texto completo de la key se devuelve una sola vez en la creación.
  • Las keys revocadas responden 401 Unauthorized de inmediato.
  • Rate limit por defecto: 60 requests/minuto por key.

​
Create API Key

POST /api/companies/{companyId}/api-keys

​
Headers

HeaderRequerido
Authorization✅ (Bearer {jwt})
Content-Type✅

​
Body

​
name
string
required
Nombre descriptivo de la key (p. ej. “Production Integration”).
curl -X POST "https://api.cobrix.co/api/companies/{companyId}/api-keys" \
  -H "Authorization: Bearer {jwt-token}" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production Integration" }'

{
  "id": "key-uuid",
  "name": "Production Integration",
  "keyPrefix": "sk_live_acme_PqL...",
  "environment": "live",
  "permissions": ["payments:create", "payments:read"],
  "rateLimitRpm": 60,
  "createdAt": "2026-03-26T14:00:00.000Z",
  "key": "sk_live_acme_PqL9Kx2Yj7mN8vZqWpTr3bS5dFgH..."
}
Guarda el valor de key inmediatamente. No se mostrará nuevamente.

​
List API Keys

GET /api/companies/{companyId}/api-keys
Devuelve la lista de keys (sin el valor completo — solo keyPrefix).

​
Revoke API Key

DELETE /api/companies/{companyId}/api-keys/{keyId}
Respuesta: 204 No Content. La key deja de ser válida de inmediato.

​
Rotate API Key

POST /api/companies/{companyId}/api-keys/{keyId}/rotate
Revoca la key actual y crea una nueva con el mismo nombre y permisos. La respuesta incluye el nuevo valor completo (solo una vez).