v4

latestOpenAPI 3.1.02026-07-31155218294.8 KB
Agents

Create Dashboard Launch Token

Mint a single-use launch URL for the dashboard.

Called by the launcher page right when readyz flips ready. The launch URL is used as a top-level navigation; /launch then sets the oc_auth cookie and 302s into the proxied dashboard.

The user's bearer token is stashed in Redis under the token's jti and retrieved (atomic GETDEL) on /launch redeem — this keeps the bearer out of the URL and out of any signed payload while preserving the existing proxy auth flow (oc_auth cookie value = bearer token).

Refuses instances whose agent_type has has_dashboard=False (e.g. hermes).

post/v1/agents/{instance_id}/launch_token

Path parameters

instance_idstring required

Headers

xi-api-keystring nullable
x-api-keystring nullable

Response

Successful Response

dashboard_urlstring required

Single-use URL that opens the dashboard. Short TTL; mint right before navigating.