Gerenciamento

Listar API Keys

Lista as API keys gerenciadas pelo usuário para o token de gerenciamento da organização atual.

GEThttps://api.tokenlab.sh/v1/management/api-keys

Visão geral

Retorna as API keys do usuário na organização associada ao token de gerenciamento atual.

Notas

  • Campos monetários são apenas em USD.

  • Chaves gerenciadas pelo sistema são excluídas.

Exemplo

pageintegerquerypadrão: 1
Número da página começando em 1.
limitintegerquerypadrão: 50
Tamanho da página de 1 a 100.

Requisição

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

Requisição / Resposta

Esta página fornece o esquema 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.

Exemplo de resposta

Resposta

200 OK
{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-live...",
      "status": "active",
      "limit_amount": 500,
      "limit_amount_decimal": "500",
      "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
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Campos importantes

objectstring
Sempre list.
dataarray
Array de objetos de API key.
paginationobject
Metadados de paginação com page, limit, total e totalPages.
data[].idstring
Identificador da API key usado em chamadas subsequentes da Management API.
data[].namestring
Nome de exibição da API key.
data[].key_prefixstring
Prefixo não secreto da chave para exibição e suporte.
data[].statusstring
Um entre active, inactive, suspended ou revoked.
data[].limit_amountnumber | null
Limite de gastos em USD como um número JSON para exibição. null significa ilimitado.
data[].limit_amount_decimalstring | null
Limite exato de gastos em USD como uma string decimal. null significa ilimitado.
data[].used_amountnumber
Uso acumulado em USD como um número JSON para exibição.
data[].used_amount_decimalstring
Uso acumulado exato em USD como uma string decimal.
data[].modelsstring[]
Lista de permissão de modelos por chave. Um array vazio significa que não há restrição adicional de modelo no nível da chave.
data[].delivery_policystring | null
auto, verified, official, null. null herda a política de entrega do Workspace.
data[].expires_atstring | null
Timestamp ISO de quando a chave expira, ou null para sem expiração.
data[].last_used_atstring | null
Timestamp ISO do uso mais recente, ou null quando não utilizada.
data[].created_atstring
Timestamp ISO de criação.

Autorização

ManagementTokenAuth
AuthorizationBearer <token>

Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.

Local: header

Resposta

application/json

application/json

application/json