> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truagents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API specification

> Machine-readable OpenAPI 3.0.3 specification for the TruAgents public API.

TruAgents publishes a single OpenAPI 3.0.3 specification that describes its public API — today, OAuth token issuance and the Unsubscribe endpoints. Generate client SDKs from it, import into Postman or Insomnia, or drive contract tests; use the linked prose guide for setup context, examples, and edge-case behavior.

## Machine-readable specification

<Card title="TruAgents public API" icon="file-code" href="/openapi/truagents.json">
  Covers `POST /oauth/token` and the `/api/v1/unsubscribe/{email,sms,phone}` operations.
</Card>

<Note>
  **Building in Python?** The first-party [`truagents` SDK](/sdks/python) wraps this spec with auto-refreshing OAuth tokens, retries, and typed exceptions — usually the fastest path from `pip install` to production.
</Note>

## Conventions

* **Location.** The spec is served at `/openapi/truagents.json` on this docs site.
* **Version.** `openapi: "3.0.3"`.
* **One spec, growing coverage.** New public operations land in this file as they ship; there is no per-domain split.
* **Prose is authoritative.** The integration mdx is the canonical narrative. If the JSON drifts from the prose, treat the prose page as source of truth and report the mismatch so we can fix the spec.

## Related pages

* [Unsubscribe API](/integrations/unsubscribe-api)
* [Authentication](/developers/authentication)
* [Integrations overview](/integrations/overview)
* [Errors and status codes](/developers/errors-and-status-codes)