Administración

Listar claves API

Lista las claves API gestionadas por el usuario para el token de administración actual de la organización.

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

Resumen

Devuelve las claves API de usuario de la organización asociada al token de administración actual.

Notas

  • Los campos monetarios solo admiten USD.

  • Las claves gestionadas por el sistema se excluyen.

Ejemplo

pageintegerquerypredeterminado: 1
Número de página a partir de 1.
limitintegerquerypredeterminado: 50
Tamaño de página de 1 a 100.

Solicitud

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

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
{
  "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-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
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Campos importantes

objectstring
Siempre list.
dataarray
Array de objetos de clave API.
paginationobject
Metadatos de paginación con page, limit, total y totalPages.
data[].idstring
Identificador de clave API usado en llamadas posteriores a la API de gestión.
data[].namestring
Nombre para mostrar de la clave API.
data[].key_prefixstring
Prefijo de clave no secreto para visualización y soporte.
data[].statusstring
Uno de los valores active, inactive, suspended o revoked.
data[].limit_amountnumber | null
Límite de gasto en USD como número JSON para visualización. null significa sin límite.
data[].limit_amount_decimalstring | null
Límite de gasto exacto en USD como cadena decimal. null significa sin límite.
data[].used_amountnumber
Gasto de uso acumulado en USD como número JSON para visualización.
data[].used_amount_decimalstring
Gasto de uso acumulado exacto en USD como cadena decimal.
data[].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.
data[].delivery_policystring | null
auto, verified, official, null. null hereda la política de entrega del espacio de trabajo.
data[].expires_atstring | null
Marca de tiempo ISO en la que vence la clave, o null si no caduca.
data[].last_used_atstring | null
Marca de tiempo ISO del uso más reciente, o null si nunca se ha usado.
data[].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

Respuesta

application/json

application/json

application/json