Administración
Actualizar API Key
Actualiza una API Key de usuario existente para la organización actual.
Resumen
Usa este endpoint para actualizar el nombre, el límite de uso, los modelos permitidos, la caducidad o el estado de una API Key existente.
Cuerpo de la solicitud
Debe enviarse al menos un campo.
| Campo | Tipo | Valor predeterminado / límites | Notas |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | longitud 1-50 | Nombre visible actualizado |
limitAmount | number | string | null | 0–100000 USD | null significa sin límite; 0 impide el gasto. Las cadenas decimales admiten hasta 6 decimales. |
limitCurrency | enum | predeterminado USD | Solo USD. Enviar CNY devuelve 400 currency_retired. Si se especifica, también se requiere limitAmount. |
models | string[] | - | Lista actualizada de modelos lógicos permitidos |
deliveryPolicy | string | null | auto, verified, official, null | null hereda la política de entrega del espacio de trabajo. |
expiresAt | string | null | datetime RFC3339 | null borra la caducidad |
Notas
-
Los campos monetarios solo admiten USD. Las entradas
CNYestán retiradas y devuelven400 currency_retired. -
La eliminación dura no está soportada a propósito en Management API v1.
-
revokedes un estado terminal para el uso operativo normal; crea una nueva clave en lugar de esperar un futuro flujo de reactivación.
Solicitud
curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"status": "inactive",
"limitAmount": 0
}'Solicitud / Respuesta
Esta página ofrece el esquema OpenAPI y ejemplos de solicitudes que puedes copiar. Envía las solicitudes de gestión desde tu terminal o cliente con un Management Token; esta página no permite enviarlas directamente.
Respuesta
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "inactive",
"limit_amount": 0,
"limit_amount_decimal": "0",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-3-7-sonnet"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
}Campos importantes
active, inactive, suspended o revoked.null significa sin límite.null significa sin límite.auto, verified, official, null. null hereda la política de entrega del espacio de trabajo.null si no caduca.null si nunca se ha usado.Autorización
ManagementTokenAuth Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.
Ubicación: header
Parámetros de ruta
Cuerpo de la solicitud
application/json
Se debe proporcionar al menos un campo.
1 <= propertiesRespuesta
application/json
application/json
application/json
application/json
application/json
application/json