Listar las claves de API
GET /v1/api-keys · permiso api-keys:read
Lista las claves de API de gestión del entorno, de la más reciente a la más antigua (order=asc invierte el orden); se incluyen las claves revocadas y caducadas. La clave sin procesar nunca se devuelve, solo metadatos.
Solicitud
| Parámetro | En | Descripción |
|---|---|---|
limit |
query | Tamaño de página, de 1 a 100. |
after |
query | Cursor de la página siguiente (list_metadata.after). |
before |
query | Cursor de la página anterior (list_metadata.before). |
order |
query | desc (predeterminado, más reciente primero) o asc. |
Respuesta
200 OK. last_used_ip se trunca a un prefijo /24 (IPv4) o /48 (IPv6).
{
"data": [
{
"id": "key_0000000000000000000000001z",
"name": "ci",
"type": "restricted",
"permissions": ["users:read"],
"allowed_cidrs": [],
"last4": "xxxx",
"created_by": "key_…",
"created_at": "2026-10-01T10:00:00Z",
"expires_at": "2027-10-01T10:00:00Z",
"last_used_at": null,
"last_used_ip": null,
"rotated_from": null,
"revoked_at": null,
"revoke_reason": null
}
],
"list_metadata": { "before": null, "after": null }
}
Errores
| HTTP | code |
Cuándo |
|---|---|---|
| 400 | invalid_cursor |
El cursor no es válido. |
| 401 | unauthenticated |
Falta la clave, no es válida o está revocada. |
| 403 | insufficient_permissions |
La clave no tiene el permiso necesario. |
| 422 | validation_failed |
Un parámetro de consulta no es válido (por ejemplo, limit fuera de 1–100). |
Ejemplo
curl "https://api.eu.keenauth.com/v1/api-keys?limit=20" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"