Gestión de Tokens

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

Usa esta página para seleccionar el flujo de token adecuado para tu integración.

¿Qué token necesito?

Token de Workspace

Rutas /api/v1/*.Automatiza operaciones de Workspace — crea proyectos, gestiona usuarios, interactúa con archivos ingestados y más.

Token de Gateway

Rutas /api/gpt/v1/*.Llama directamente a la API de ZylonGPT, de la misma forma que usarías la API de Anthropic.

Token de Workspace
Token de Gateway (ZylonGPT)

Este flujo es para el acceso a la API de Workspace bajo /api/v1/*.

El flujo de token de Workspace no emite tokens para llamadas directas a la API de ZylonGPT bajo /api/gpt/v1/*.

Crea un token de API de Workspace

Inicia sesión en Workspace con una cuenta que pueda gestionar tokens de API.
Haz clic en el logo de la organización y abre API Tokens.
Haz clic en Create API Token, proporciona un nombre y guarda.
Copia y almacena el valor del token inmediatamente. Se muestra solo una vez.

Verifica el acceso del token

Los endpoints de Workspace bajo /api/v1/app/* requieren el header x-org.

curl "https://{BASE_URL}/api/v1/app/me" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "account_id": "acct_6c8a1f3b2d4e5f7a",
  "name": "Sasha Patel",
  "email": "sasha@auroralabs.com",
  "state": "Active",
  "roles": ["AppAdmin"],
  "created_at": "2026-02-08T14:12:45Z"
}

Revoca un token de Workspace

Abre API Tokens y haz clic en el icono de papelera en la fila del token.

Este flujo otorga acceso a la API de ZylonGPT bajo /api/gpt/v1/*, así como a las APIs de Workspace y Backoffice.

Crea un token de Gateway

Abre Developer Console.
Selecciona el gateway de destino.
Haz clic en Create API Token.
Introduce un nombre para el token.
Genera el token.
Copia el secreto del token que aparece en el modal.

El secreto del token se muestra solo una vez. Una vez cerrado el modal, no podrá recuperarse. Guárdalo en un gestor de secretos seguro de inmediato.

Scopes de token de API

La creación de tokens de cuenta acepta estos seis valores serializados de scope:

Scope	Acceso
`Read.All`	Lectura de cuentas, tokens, gateways, Backoffice/metadatos y Workspace, búsqueda en Workspace y allowlist de solo lectura de ZylonGPT cuando el token incluye `gateway_id`.
`ReadWrite.All`	Lectura y escritura en las APIs, según los roles de la cuenta propietaria.
`Workspace.Read.All`	Lecturas y búsquedas de Workspace; las mutaciones de Workspace devuelven `403`.
`Workspace.ReadWrite.All`	Operaciones de lectura y escritura de Workspace.
`PrivateGPT.Read.All`	Solo la allowlist de ZylonGPT de lectura para el gateway seleccionado.
`PrivateGPT.ReadWrite.All`	Operaciones de lectura y escritura de ZylonGPT para el gateway seleccionado.

Si un token tiene varios scopes, sus permisos se combinan. Después, los permisos efectivos se limitan a los permisos de la cuenta y el rol propietarios del token. Un scope amplio no puede elevar a su propietario y un token de API de solo lectura sigue restringido aunque su propietario sea SuperAdmin. Estas restricciones de scope solo se aplican a tokens de API; las sesiones interactivas no cambian.

Si una solicitud de token de cuenta omite scopes, se usa Workspace.ReadWrite.All por defecto. Enviar un array scopes vacío de forma explícita devuelve 400. Tanto PrivateGPT.Read.All como PrivateGPT.ReadWrite.All requieren gateway_id.

Read.All no requiere gateway_id al crear el token. Sin ese contexto de gateway, el token puede usar sus demás permisos de lectura, pero no puede llamar a ZylonGPT. La creación de tokens de gateway solo acepta PrivateGPT.Read.All y PrivateGPT.ReadWrite.All; solicitar otro scope devuelve 400. Por compatibilidad, el endpoint de tokens de gateway convierte una lista de scopes legacy vacía explícita en PrivateGPT.ReadWrite.All. Consulta la visión general de ZylonGPT API para ver la lista de endpoints de solo lectura y los requisitos de lectura y escritura.

Primeros pasos

Construye con Zylon

Coding Agents

Gestión de Tokens

¿Qué token necesito?

Token de Workspace