Send a candidate for review

POST 
/v1/projects/:project_id/reviews

Required scopeprojects:writeWhat are scopes?

Sends a candidate in a project to a user for review.

Request

Responses

201

Review requested

401

Missing or invalid bearer token.

403

The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to send candidates in this project for review, or the API key lacks the projects:write scope (err_insufficient_scope).

404

Project not found (err_project_not_found).

409

The candidate already has a pending or decided review in this project (err_candidate_already_in_review).

422

Validation failed. Error codes:

• err_candidate_id_not_in_project — candidate_id isn't a candidate in the project
• err_candidate_anonymized — the candidate's data was anonymized
• err_reviewer_not_found — the reviewer is not an active user in the account
• err_user_cannot_collaborate_on_projects — the reviewer doesn't have the projects:collaborate permission
• err_job_stage_not_found — unknown stage, or one the acting user can't view
• err_job_not_open — the stage's job isn't published or scheduled
• err_review_invalid — the review request couldn't be saved
• err_project_archived — the project is archived
• err_system_project — the project is the system project
• err_on_behalf_of_not_allowed — a personal access token passed another user's ID
• err_user_not_found — on_behalf_of is not an active user in the account
• err_on_behalf_of_forbidden — that user is not allowed to perform this action