# API reference
URL: https://docs.awellhealth.com/api-reference

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).



The Orchestration API is how your systems read and write care-orchestration data (patients,
care flows, activities, and more) over a single GraphQL endpoint.

Start with the guides, then use the operation reference for the domain you need.

## Guides [#guides]

* **[Getting started](/api-reference/guides/getting-started)** — make your first authenticated request.
* **[Authentication](/api-reference/guides/authentication)** — obtain and send an API key.
* **[Environments](/api-reference/guides/environments)** — sandbox, production, and regions.
* **[Pagination](/api-reference/guides/pagination)** — page and sort list results.
* **[Errors](/api-reference/guides/errors)** — read the `code` / `success` envelope and GraphQL errors.
* **[Rate limits](/api-reference/guides/rate-limits)** — limits and backoff.
* **[Mutations](/api-reference/guides/mutations)** — an orientation to the write API.
* **[Webhooks](/api-reference/guides/webhooks)** — receive, inspect, and retry webhook calls.

## Reference [#reference]

Operations are grouped by domain:

* [Patients](/api-reference/reference/patients)
* [Care flows](/api-reference/reference/care-flows)
* [Activities](/api-reference/reference/activities)
* [Activity types](/api-reference/reference/activity-types)
* [Tracks](/api-reference/reference/tracks)
* [Stakeholders](/api-reference/reference/stakeholders)
* [Timers](/api-reference/reference/timers)
* [Hosted sessions & pages](/api-reference/reference/hosted-sessions)
* [API calls & webhooks](/api-reference/reference/api-calls-and-webhooks)
* [Subscriptions](/api-reference/reference/subscriptions)
* [Tenant](/api-reference/reference/tenant)