API Reference

Start with the curated Essentials, then switch to the full reference — both live here, over the same OpenAPI artifact.

Limits & throughput

Calls are rate-limited per credential. A throttled call returns 429 and its response headers say how long to wait before retrying — they are listed on each operation in the reference below.

Live

Bulk endpoints are live: import up to 100 people per call, and assign to 100 at a time. So 10,000 people is about 100 batched calls, idempotent by email. To learn when each assignment completes, subscribe to the assessment.completed event rather than polling.

/colleagues/bulk/colleagues/bulk/validate/assessments/assignments/bulk

To react to a completion without polling, subscribe to the assessment.completed event. Every event Thomas sends, and how to verify it, is on the Webhooks page.

Loading the reference…