Skip to main content
Use this page to pick the right token flow for your integration.

Which token do I need?

Workspace Token

Routes /api/v1/*.Automate Workspace operations — create projects, manage users, interact with ingested files, and more.

Gateway Token

Routes /api/gpt/v1/*.Call the ZylonGPT API directly, the same way you’d use the Anthropic API.
This flow is for Workspace API access under /api/v1/*.
Workspace token flow does not issue tokens for direct ZylonGPT API calls under /api/gpt/v1/*.

Create a Workspace API token

  1. Sign in to Workspace as an account that can manage API tokens.
  2. Click the organization logo and open API Tokens.
  3. Click Create API Token, provide a name, and save.
  4. Copy and store the token value immediately. It is shown once.

Verify token access

Workspace endpoints under /api/v1/app/* require the x-org header.
curl "https://{BASE_URL}/api/v1/app/me" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"
{
  "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"
}

Revoke a Workspace token

Open API Tokens and click the trash icon on the token row.