Getting started
Updated: 10/25/2026
On this page
Orientation 1 page
- How does a call flow through the platform?From the bearer header through the permission check to the response with a trace ID: the stations every call passes through.
The first call 4 pages
- Create an API keyIn the portal under Settings › Organization › API keys, create a key with class, permissions, and expiry. The plaintext appears exactly once.
- Your first call with curlCall GET /v1/me and GET /v1/playlists with a key and curl, and look at the response and its headers, in five minutes.
- What a response containsStatus, headers, list shape, IDs with a prefix, and the error body: everything a response of the API holds, in tables.
- Idempotency from the startProtect write calls with Idempotency-Key, so that a retry after a network drop does not create a second operation.
If you get stuck 1 page
- When the first call fails401, 403, 404, 422, 429, and network errors on the first call: what the code means and which page shows the way back.