Authorization: Bearer ptr_…, a key made under Settings › API. JSON in, JSON out. The pages in this tab are generated from the API’s own OpenAPI document, so a field here is a field the server accepts, and the playground on each page runs against your key.
The verbs
Every verb is a page in this tab’s sidebar, generated from the API’s OpenAPI document, with its route, its scope in the description, the fields it takes and what it answers. The playground on each page runs against your own key.Headers that help
Every write answers with
revision is the deck’s last save. Send it with the next write and the write lands only if nobody changed the deck since; otherwise 409. ready and problems are the readiness check, run for you.
Errors
error says what went wrong. fix, when we can tell, says what to do, and names the field when the body did not fit. The status codes are listed under Authentication and limits.
Also machine-readable
/openapi.json, the document these pages are built from./llms.txtand/llms-full.txt, the reference an agent reads first./api/mcp, the same verbs as tools.