Administración

Actualizar API Key

Actualiza una API key en el Workspace actual.

PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}

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.

CampoTipoPredeterminado / LímitesNotas
statusenum-active, inactive, revoked
namestringlongitud 1-50Nombre para mostrar actualizado
limitAmountnumber | string | null0–100000 USDnull significa sin límite; 0 evita el gasto. Las cadenas decimales admiten hasta 6 decimales.
limitCurrencyenumpredeterminado USDSolo USD. Enviar CNY devuelve 400 currency_retired. Cuando se establece, limitAmount es obligatorio.
modelsstring[]-Lista de modelos permitidos actualizada
deliveryPolicystring | nullauto, verified, official, nullnull hereda la política de entrega del Workspace.
expiresAtstring | nullfecha y hora RFC3339null elimina la caducidad

Notas

  • Los campos monetarios son solo en USD. Las entradas CNY están retiradas y devuelven 400 currency_retired.

  • La Management API no proporciona eliminación. Utilice inactive para una pausa temporal y revoked para retirar una clave permanentemente.

  • Reemplace una clave revocada por una nueva. Establecer una clave revocada como active devuelve 409 api_key_revoked.

  • suspended puede aparecer en las respuestas, pero no puede enviarlo.

Ejemplo

Solicitud

cURL
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.

Ejemplo de respuesta

Respuesta

200 OK
{
  "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

idstring
Identificador de la API key utilizado en llamadas posteriores a la Management API.
namestring
Nombre para mostrar de la API key.
key_prefixstring
Prefijo de clave no secreto para visualización y soporte.
statusstring
Uno de los siguientes: active, inactive, suspended o revoked.
limit_amountnumber | null
Límite de gasto en USD como número JSON para visualización. null significa sin límite.
limit_amount_decimalstring | null
Límite de gasto exacto en USD como cadena decimal. null significa sin límite.
used_amountnumber
Uso acumulado en USD como número JSON para visualización.
used_amount_decimalstring
Uso acumulado exacto en USD como cadena decimal.
modelsstring[]
Lista de modelos permitidos por clave. Un array vacío significa que no hay restricciones de modelo adicionales a nivel de clave.
delivery_policystring | null
auto, verified, official, null. null hereda la política de entrega del Workspace.
expires_atstring | null
Marca de tiempo ISO en la que caduca la clave, o null si no tiene caducidad.
last_used_atstring | null
Marca de tiempo ISO del uso más reciente, o null si no se ha utilizado.
created_atstring
Marca de tiempo ISO de creación.

Autorización

ManagementTokenAuth
AuthorizationBearer <token>

Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.

Ubicación: header

Parámetros de ruta

keyId*string

Cuerpo de la solicitud

application/json

Se debe proporcionar al menos un campo.

Propiedades1 <= properties

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json