Claves de API
Listar Claves de API
Obtener todas las claves de API del usuario y tenant actuales.
GET /api/api-keys
Devuelve todas las claves de API pertenecientes al usuario autenticado en el tenant activo, ordenadas por fecha de creación (más reciente primero).
Auth: Requerida — permiso MANAGE_API_KEYS
Ejemplo
curl -X GET https://api.reten.ai/api/api-keys \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"const response = await fetch("https://api.reten.ai/api/api-keys", {
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
});
const keys = await response.json();import requests
response = requests.get(
"https://api.reten.ai/api/api-keys",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
)
keys = response.json()Respuesta 200 OK
[
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "CI/CD Pipeline Key",
"keyPrefix": "rtn_sk_a1b2c3d4",
"userId": "550e8400-e29b-41d4-a716-446655440000",
"tenantId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"isActive": true,
"permissions": ["manage_commerces", "view_activities"],
"expiresAt": "2026-12-31T23:59:59.000Z",
"lastUsedAt": "2026-02-26T16:45:00.000Z",
"createdAt": "2026-02-26T14:30:00.000Z",
"revokedAt": null
},
{
"id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
"name": "Monitoring Service",
"keyPrefix": "rtn_sk_e5f6g7h8",
"userId": "550e8400-e29b-41d4-a716-446655440000",
"tenantId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"isActive": false,
"permissions": ["view_activities"],
"expiresAt": null,
"lastUsedAt": "2026-02-20T10:00:00.000Z",
"createdAt": "2026-02-01T09:00:00.000Z",
"revokedAt": "2026-02-25T12:00:00.000Z"
}
]Campos de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | string | UUID de la clave de API |
name | string | Etiqueta legible |
keyPrefix | string | Prefijo visible para identificación (ej., rtn_sk_a1b2c3d4) |
userId | string | UUID del usuario que creó la clave |
tenantId | string | UUID del tenant asociado |
isActive | boolean | true si la clave está activa, false si fue revocada |
permissions | string[] | Nombres de permisos concedidos a esta clave |
expiresAt | string | null | Fecha de expiración en formato ISO 8601, o null si no tiene expiración |
lastUsedAt | string | null | Marca de tiempo ISO 8601 del último uso, o null si nunca fue usada |
createdAt | string | Marca de tiempo de creación en formato ISO 8601 |
revokedAt | string | null | Marca de tiempo de revocación en formato ISO 8601, o null si está activa |
Respuestas de Error
| Estado | Descripción |
|---|---|
400 | Sin contexto de tenant activo |
401 | Token de autenticación faltante o inválido |
403 | Permisos insuficientes |