Administración

Actualizar API Key

Actualiza una API Key de usuario existente para la organización actual.

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

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.

CampoTipoValor predeterminado / límitesNotas
statusenum-active, inactive, revoked
namestringlongitud 1-50Nombre visible actualizado
limitAmountnumber | string | null0–100000 USDnull significa sin límite; 0 impide el gasto. Las cadenas decimales admiten hasta 6 decimales.
limitCurrencyenumpredeterminado USDSolo USD. Enviar CNY devuelve 400 currency_retired. Si se especifica, también se requiere limitAmount.
modelsstring[]-Lista actualizada de modelos lógicos permitidos
deliveryPolicystring | nullauto, verified, official, nullnull hereda la política de entrega del espacio de trabajo.
expiresAtstring | nulldatetime RFC3339null borra la caducidad

Notas

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

  • La eliminación dura no está soportada a propósito en Management API v1.

  • revoked es un estado terminal para el uso operativo normal; crea una nueva clave en lugar de esperar un futuro flujo de reactivación.

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

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

idstring
Identificador de clave API usado en llamadas posteriores a la API de gestión.
namestring
Nombre para mostrar de la clave API.
key_prefixstring
Prefijo de clave no secreto para visualización y soporte.
statusstring
Uno de los valores 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
Gasto de uso acumulado en USD como número JSON para visualización.
used_amount_decimalstring
Gasto de uso acumulado exacto en USD como cadena decimal.
modelsstring[]
Lista de modelos permitidos por clave. Un array vacío significa que no hay una restricción adicional de modelos a nivel de clave.
delivery_policystring | null
auto, verified, official, null. null hereda la política de entrega del espacio de trabajo.
expires_atstring | null
Marca de tiempo ISO en la que vence la clave, o null si no caduca.
last_used_atstring | null
Marca de tiempo ISO del uso más reciente, o null si nunca se ha usado.
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