Skip to main content
The Ontora API has regional hosts:
Use the host matching the dashboard where the workspace and API key were created: app.ontora.com uses US, while eu.ontora.com uses EU. API keys are region-bound.

​
Authentication

All endpoints accept either a Clerk JWT or a workspace API key:
For programmatic integrations, use a workspace API key. See Authentication for how to create and rotate keys.

​
Versioning

The API is versioned in the path. The current stable version is v1 (US shown):
Breaking changes will go out under v2. Additive changes (new fields, new endpoints) ship in v1 without a version bump.

​
Content types

  • Requests: application/json
  • Responses: application/json unless otherwise specified
  • Exports: text/markdown or application/zip

​
OpenAPI

The OpenAPI 3 spec for each regional API is available at:
The endpoint pages in this section are generated from that spec — they reflect the live API.

​
Errors

See Errors for the full list of status codes and error shapes.