API reference

The Dokaz REST API is versioned under /v1. The machine-readable OpenAPI 3.1 document is at /openapi.json.

Authentication

Create an API key on the API keys page, then send it as a bearer token:

curl https://app.dokaz.io/v1/drills \ -H "Authorization: Bearer so_your_key_here"

Conventions

• Every response is a { data, meta, errors } envelope.
• List endpoints paginate with an opaque cursor; follow meta.next_cursor.
• POST requests require an Idempotency-Key header; a repeated key replays the original response.
• Rate limit: 60 requests per minute per account; over the limit returns 429 with Retry-After.

Endpoints