Skip to main content

​
Base URL

The machine-readable spec is at /openapi.json.

​
Requests

  • Send Authorization: Bearer <token> on every request (see Authentication).
  • Send JSON bodies with Content-Type: application/json. Bodies are limited to 100 KB, or 5 MB when updating a project’s content.
  • Every response carries an X-Request-Id header. Include it when you contact support.
Successful responses wrap the result in data:
Errors use one envelope; see Errors.

​
Pagination

GET /projects returns up to limit items (default 25, max 100) and a cursor:
Pass cursor=<next_cursor> to get the next page.

​
Idempotency

Send an Idempotency-Key header (up to 200 characters) on POST /presentations. Retrying with the same key returns the original job and project instead of generating, and charging for, a second one.

​
Generation

POST /presentations generates and saves the whole project before it responds. Allow at least 3 minutes before your client times out. Each call is recorded as a job you can read with GET /jobs/{job_id}.