Gerenciamento
Atualizar chave de API
Atualize uma chave de API no Workspace atual.
Visão geral
Use este endpoint para atualizar o nome, limite de uso, modelos permitidos, expiração ou status de uma chave de API de usuário existente.
Corpo da requisição
Pelo menos um campo deve ser fornecido.
| Campo | Tipo | Padrão / Limites | Observações |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | comprimento 1-50 | Nome de exibição atualizado |
limitAmount | number | string | null | 0–100000 USD | null significa ilimitado; 0 impede gastos. Strings decimais suportam até 6 casas decimais. |
limitCurrency | enum | padrão USD | Apenas USD. O envio de CNY retorna 400 currency_retired. Quando definido, limitAmount é obrigatório. |
models | string[] | - | Lista de permissões de modelos atualizada |
deliveryPolicy | string | null | auto, verified, official, null | null herda a política de entrega do Workspace. |
expiresAt | string | null | data e hora RFC3339 | null remove a expiração |
Observações
-
Campos monetários são apenas em USD. Entradas em
CNYforam descontinuadas e retornam400 currency_retired. -
A Management API não oferece exclusão. Use
inactivepara uma pausa temporária erevokedpara desativar uma chave permanentemente. -
Substitua uma chave revogada por uma nova. Definir uma chave revogada como
activeretorna409 api_key_revoked. -
suspendedpode aparecer nas respostas, mas você não pode enviá-lo.
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 schema OpenAPI e exemplos de requisição copiáveis. Envie requisições de gerenciamento a partir do seu terminal ou cliente com 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-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 ou revoked.null significa ilimitado.null significa ilimitado.auto, verified, official, null. null herda a política de entrega do Workspace.null para nenhuma expiração.null quando não utilizada.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