Claves de API

Crear clave de API

POST /api/v1/api-keys

Crea una nueva clave de API para el usuario autenticado.

Cuerpo de la solicitud

{
  "name": "My integration"
}

Campo	Requerido	Descripción
`name`	Sí	Nombre para mostrar de la clave (1-100 caracteres)

Respuesta

{
  "data": {
    "id": "key_uuid",
    "name": "My integration",
    "prefix": "rm_abc123",
    "key": "rm_abc123def456...",
    "created_at": "2025-09-19T15:00:00.000Z"
  }
}

Listar claves de API

GET /api/v1/api-keys

Devuelve todas las claves de API para el usuario autenticado. El valor completo de la clave nunca se devuelve después de la creación.

Respuesta

{
  "data": [
    {
      "id": "key_uuid",
      "name": "My integration",
      "prefix": "rm_abc123",
      "created_at": "2025-09-19T15:00:00.000Z",
      "last_used_at": "2025-09-20T10:30:00.000Z",
      "is_revoked": false
    }
  ]
}

Revocar clave de API

DELETE /api/v1/api-keys/:id

Revoca permanentemente una clave de API. Las solicitudes que utilicen esta clave fallarán inmediatamente con INVALID_API_KEY.

Respuesta

{
  "data": { "success": true }
}

Códigos de error

Código	Estado HTTP	Significado
`API_KEY_NOT_FOUND`	404	La clave no existe o pertenece a otro usuario
`ALREADY_REVOKED`	400	La clave ya fue revocada