# xplatform

> Files, auth, commerce and marketing, provisioned into a customer's project
> as independent services with separate infrastructure, then assembled into a
> system that fits them. This documentation covers the control plane and each
> service.

Every page below is also available as raw markdown at the same path under
/docs/raw/. Append nothing and parse nothing — it is the same source the
human-readable pages render from.

## Start here

- [Quickstart](https://xplatform.dev/docs/raw/start/quickstart): From a new account to your first successful API call, in about two minutes. (building)

## Auth API

- [Auth](https://xplatform.dev/docs/raw/auth-api): Sign-up, sign-in, sessions and JWTs for your app's users, with your users in a database of their own. (building)

## Files API

- [Files API](https://xplatform.dev/docs/raw/files-api): Every endpoint, one page each, with the request and response it actually returns. (building)
- [Upload files](https://xplatform.dev/docs/raw/files-api/upload-files): One operation, three calls — get a URL, send the bytes, confirm they landed. (building)
- [Get files](https://xplatform.dev/docs/raw/files-api/get-files): List and filter, or fetch one by id. Every result carries its URLs already. (building)
- [Update files](https://xplatform.dev/docs/raw/files-api/update-files): Change visibility, ownership, position or transform settings — and what moves when you do. (building)
- [Delete files](https://xplatform.dev/docs/raw/files-api/delete-files): One file, or everything attached to one of your objects. (building)
- [Restoring a deleted file](https://xplatform.dev/docs/raw/files-api/restoring): Deletes are reversible for 30 days — how to see what is recoverable and bring it back. (building)
- [Signed URLs](https://xplatform.dev/docs/raw/files-api/signed-urls): Private files expire after five minutes. How to get a fresh set, and when not to. (building)
- [The file object](https://xplatform.dev/docs/raw/files-api/file-object): Every field a file response carries, and which ones can be absent. (building)
- [Limits and formats](https://xplatform.dev/docs/raw/files-api/limits): Sizes, expiries, widths, and every accepted content type. (building)

## Platform

- [What xplatform is](https://xplatform.dev/docs/raw/platform): A control plane that provisions independent services into a project, and the reasoning behind that shape. (building)
- [Usage and billing](https://xplatform.dev/docs/raw/platform/usage-and-billing): How services report what they used, why gauges and counters need different plumbing, and how limits are enforced. (building)
- [Operating it](https://xplatform.dev/docs/raw/platform/operating): Scheduled jobs, how a failure surfaces, and the one endpoint a monitor should watch. (building)

## Everything at once

- [Full documentation](https://xplatform.dev/docs/llms-full.txt): every page above, concatenated.