Documentation

Written once, for people and machines

Every page here is a markdown file in /docs. This site renders them; it is not where they live. Edit the file and the page follows.

Start here

1 page
QuickstartFrom a new account to your first successful API call, in about two minutes.building

Auth API

1 page
AuthSign-up, sign-in, sessions and JWTs for your app's users, with your users in a database of their own.building

Files API

9 pages
Files APIEvery endpoint, one page each, with the request and response it actually returns.building
Upload filesOne operation, three calls — get a URL, send the bytes, confirm they landed.building
Get filesList and filter, or fetch one by id. Every result carries its URLs already.building
Update filesChange visibility, ownership, position or transform settings — and what moves when you do.building
Delete filesOne file, or everything attached to one of your objects.building
Restoring a deleted fileDeletes are reversible for 30 days — how to see what is recoverable and bring it back.building
Signed URLsPrivate files expire after five minutes. How to get a fresh set, and when not to.building
The file objectEvery field a file response carries, and which ones can be absent.building
Limits and formatsSizes, expiries, widths, and every accepted content type.building

Platform

3 pages
What xplatform isA control plane that provisions independent services into a project, and the reasoning behind that shape.building
Usage and billingHow services report what they used, why gauges and counters need different plumbing, and how limits are enforced.building
Operating itScheduled jobs, how a failure surfaces, and the one endpoint a monitor should watch.building

For machines

The same docs, without the chrome

An AI reading these should not have to strip HTML or run JavaScript. Three plain-text surfaces, served from the same markdown as the pages above, so they cannot drift apart.

/docs/llms.txtAn index: what this is, and one line per page. A few hundred tokens, enough to decide what to fetch.
/docs/llms-full.txtAll 14 pages concatenated, each labelled with its source path.
/docs/raw/{path}Any single page as raw markdown.