Errors

Errors use { "error": { "code", "message", "details?" } }.

Code	Type	HTTP	Description
unauthorized	string	401	Missing or invalid API key
forbidden	string	403	Revoked API key or trial write blocked (distinct from upgrade_required)
upgrade_required	string	403	Organization is on the free plan; upgrade to a paid plan (2+ users)
not_found	string	404	Resource not in your organization
validation_error	string	400	Invalid input
invalid_pipeline_status	string	400	Status not in org pipeline
candidate_limit_reached	string	403	Candidate database limit
talent_pool_reveal_required	string	403	Masked talent pool profile
insufficient_credits	string	403	Not enough Talynce credits (e.g. video interview API requires 10 credits)
rate_limit_exceeded	string	429	Too many requests; Retry-After header is integer (seconds)
internal_error	string	500	Server error

Errors

Errors use { "error": { "code", "message", "details?" } }.

Code	Type	HTTP	Description
unauthorized	string	401	Missing or invalid API key
forbidden	string	403	Revoked API key or trial write blocked (distinct from upgrade_required)
upgrade_required	string	403	Organization is on the free plan; upgrade to a paid plan (2+ users)
not_found	string	404	Resource not in your organization
validation_error	string	400	Invalid input
invalid_pipeline_status	string	400	Status not in org pipeline
candidate_limit_reached	string	403	Candidate database limit
talent_pool_reveal_required	string	403	Masked talent pool profile
insufficient_credits	string	403	Not enough Talynce credits (e.g. video interview API requires 10 credits)
rate_limit_exceeded	string	429	Too many requests; Retry-After header is integer (seconds)
internal_error	string	500	Server error