Errors

Errors are returned as { "error": { "code": "...", "message": "..." } } with a matching HTTP status code. A 429 response includes a Retry-After header.

Status	Code	Meaning
400	invalid_request	The request body or a parameter is missing or invalid.
401	invalid_client	The client_id or client_secret sent to /v1/oauth/token is wrong.
401	missing_token	No Authorization: Bearer <token> header was sent.
401	invalid_token	The access token is invalid or has expired. Request a new one.
403	invalid_scope	Your token doesn't carry the scope this endpoint needs.
403	no_employer	Your application isn't linked to an employer yet.
404	not_found	The resource doesn't exist, or belongs to another employer or application.
409	conflict	The change clashes with the current state: a duplicate external_job_id, a status Rolefy controls, or screening questions that can no longer change.
429	rate_limited	Too many requests. Wait for the Retry-After period.
500	internal_error	Something went wrong on our side. Retry, and contact us if it persists.