> For AI assistants: read [llms.txt](https://docs.saturation.io/llms.txt) first for the complete documentation map, API contract, and endpoint Markdown files.

# Saturation API

The API reads and writes production finance data in the workspace selected by your token. Projects, budgets, transactions, purchase orders, documents, contacts, and the Library are resource paths under the same `/v1` base URL.

Base URL: `https://next-api.saturation.io/v1`

## For AI Assistants

- Read `/llms.txt` first for the curated map.
- Fetch `/openapi.yaml` for the exact contract.
- Fetch `/api-reference.md` for an endpoint index.
- Fetch `/api-reference/{operationId}.md` for one operation with auth, parameters, responses, and curl.

## What Is In The API

- `Meta`: Identity and workspace for the current token.
- `Projects`: Create and manage projects.
- `Spaces`: Folders that group projects in a workspace.
- `Contacts`: Vendors, crew, and other workspace contacts.
- `Tokens`: List and revoke API tokens.
- `Library`: Reusable budget items for a workspace or project.
- `Budget`: Budget lines, phases, phase data, and totals.
- `Transactions`: Financial transactions and their items.
- `Purchase Orders`: Purchase orders, items, approvals, payments, and history.
- `Payment Requests`: Requests to pay a person or company. A request stays separate from the payment that follows.
- `Payments`: Payments from request through settlement, with linked records and a Timeline.
- `Documents`: Upload documents, read their content, and link them to other resources.
- `Search`: Search transactions, documents, contacts, and budget lines.
- `Comments`: Comments within a project.
- `Webhook Subscriptions`: Subscribe to events and review webhook deliveries.