Authentication

Today: private beta

The API is in private beta and not yet generally available — there is no public token auth yet. https://api.tiltdesk.xyz is the base URL reserved for the public launch.

Tokens are coming

Public access with API tokens (issue, scope, revoke) and rate limits is on the roadmap. The playground’s live “Try it” will work end-to-end once that ships. Until then, it renders the request/response shapes.

What the token flow will look like (planned)

1. Sign in to the dashboard and create a scoped, revocable token.
2. Send it as a bearer header:

   curl -H "Authorization: Bearer tk_…" https://api.tiltdesk.xyz/v1/markets

3. Rotate/revoke from the dashboard; requests are rate-limited per token.

We’ll update this page with the real flow when auth lands.