v9

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2181734.3 KB
publicAPI

Rotate public API token

Rotates the Public API token for a partner-managed workspace. A new token is generated, persisted according to the platform’s security rules, and the previous token is invalidated immediately. Each successful rotation returns the new raw token value and the rotated_at timestamp. Subsequent calls rotate the token again; the operation is not idempotent. Workspace ownership and billing eligibility checks apply. Partners are expected to update their integrations to use the newly issued token as soon as it is returned.

post/workspaces/{workspace_id}/api-token

Path parameters

workspace_idstring required

The unique identifier for the workspace.

Headers

X-TL-Partner-Idstring required

The unique identifier for the partner.

Response

Token rotated

workspace_idstring required

Unique identifier for the workspace

tokenstring required

Raw Public API token value

rotated_atstring date-time

Timestamp when the token was rotated and became invalid.

Example response

{
  "rotated_at": "2024-01-01T12:00:00Z"
}