Get public API token

Retrieves the current Public API token for a partner-managed workspace. If a token already exists it is returned as the raw token value so that the partner can configure it in their integration. If no token exists yet, the platform creates a new one and returns it. Only workspaces owned by the calling partner and not billed via are eligible. The response must be treated as sensitive: tokens are returned only over authenticated Partner API calls .

GET /workspaces/{workspace_id}/api-token

Get public API token

cURL

curl --request GET \
  --url https://app.timelines.ai/partner/api/v1/workspaces/{workspace_id}/api-token \
  --header 'Authorization: Bearer <token>' \
  --header 'X-TL-Partner-Id: <x-tl-partner-id>'

200

{
  "workspace_id": "<string>",
  "token": "<string>",
  "rotated_at": "2024-01-01T12:00:00Z"
}

Authorizations

Authorization · string · header · required

JWT bearer authentication. The token payload must include partner_id, nbf (not-before) and exp (expiry) claims. All Partner API requests must be authenticated with Authorization: Bearer .

Headers

X-TL-Partner-Id · string · required

The unique identifier for the partner.

Path Parameters

workspace_id · string · required

Response

200 - application/json

Public API token

Response payload for retrieving or rotating a workspace Public API token. Returns the workspace_id and the raw token value, and, for rotation calls, the rotated_at timestamp that indicates when the previous token became invalid.

workspace_id · string · required

Unique identifier for the workspace

token · string · required

Raw Public API token value

rotated_at · string<date-time>

Timestamp when the token was rotated and became invalid.

Example:

"2024-01-01T12:00:00Z"