Gerenciamento
Atualizar API Key
Atualiza uma API Key de usuário existente da organização atual.
Visão geral
Use este endpoint para atualizar nome, limite de uso, modelos permitidos, data de expiração ou status de uma API Key existente.
Corpo da requisição
A requisição PATCH deve incluir pelo menos um campo.
| Campo | Tipo | Padrões / limites | Descrição |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | tamanho 1-50 | Nome de exibição atualizado |
limitAmount | number | string | null | 0–100000 USD | null significa sem limite; 0 impede gastos. Strings decimais aceitam até 6 casas decimais. |
limitCurrency | enum | padrão USD | Apenas USD. Enviar CNY retorna 400 currency_retired. Se informado, limitAmount também é obrigatório. |
models | string[] | - | Allowlist atualizada de modelos lógicos |
deliveryPolicy | string | null | auto, verified, official, null | null herda a política de entrega do espaço de trabalho. |
expiresAt | string | null | datetime RFC3339 | null remove a expiração |
Observações
-
Os campos monetários aceitam apenas USD. Entradas em
CNYforam descontinuadas e retornam400 currency_retired. -
A exclusão definitiva não é suportada intencionalmente na Management API v1.
-
revokedcostuma ser tratado como estado terminal; se você precisar usar outra chave, normalmente é melhor criar uma nova.
Requisição
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
}'Requisição / Resposta
Esta página fornece o esquema OpenAPI e exemplos de requisições para copiar. Envie solicitações de gerenciamento pelo terminal ou cliente usando um Management Token; o envio direto não está disponível nesta página.
Resposta
{
"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 ou revoked.null significa ilimitado.null significa ilimitado.auto, verified, official, null. null herda a política de entrega do espaço de trabalho.null quando não há expiração.null quando nunca foi usada.Autorização
ManagementTokenAuth Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.
Local: header
Parâmetros de caminho
Corpo da requisição
application/json
Pelo menos um campo deve ser fornecido.
1 <= propertiesResposta
application/json
application/json
application/json
application/json
application/json
application/json