Administración
Actualizar API Key
Actualiza una API key en el Workspace actual.
Descripción general
Utilice este endpoint para actualizar el nombre, límite de uso, modelos permitidos, fecha de caducidad o estado de una API key de usuario existente.
Cuerpo de la solicitud
Se debe proporcionar al menos un campo.
| Campo | Tipo | Predeterminado / Límites | Notas |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | longitud 1-50 | Nombre para mostrar actualizado |
limitAmount | number | string | null | 0–100000 USD | null significa sin límite; 0 evita el gasto. Las cadenas decimales admiten hasta 6 decimales. |
limitCurrency | enum | predeterminado USD | Solo USD. Enviar CNY devuelve 400 currency_retired. Cuando se establece, limitAmount es obligatorio. |
models | string[] | - | Lista de modelos permitidos actualizada |
deliveryPolicy | string | null | auto, verified, official, null | null hereda la política de entrega del Workspace. |
expiresAt | string | null | fecha y hora RFC3339 | null elimina la caducidad |
Notas
-
Los campos monetarios son solo en USD. Las entradas
CNYestán retiradas y devuelven400 currency_retired. -
La Management API no proporciona eliminación. Utilice
inactivepara una pausa temporal yrevokedpara retirar una clave permanentemente. -
Reemplace una clave revocada por una nueva. Establecer una clave revocada como
activedevuelve409 api_key_revoked. -
suspendedpuede aparecer en las respuestas, pero no puede enviarlo.
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 proporciona el esquema OpenAPI y ejemplos de solicitud copiables. Envíe las solicitudes de gestión desde su terminal o cliente con un Management Token; el envío directo no está disponible en esta página.
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-sonnet-4-6"
],
"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 Workspace.null si no tiene caducidad.null si no se ha utilizado.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