Submit a scorecard

POST 
/v1/scorecards/:id/submit

Required scopescorecards:writeWhat are scopes?

Submits a draft scorecard, saving any values sent first.

Request

Responses

200

Scorecard submitted

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 edit this scorecard, or the API key lacks the scorecards:write scope (err_insufficient_scope). Also returned when the candidate's consent blocks processing (err_consent_processing_blocked).

404

Scorecard not found (err_scorecard_not_found).

422

Validation failed. Error codes:

• err_scorecard_already_submitted — the scorecard is already submitted
• err_scorecard_not_ready — the interview hasn't ended or needs no scorecard, or the assessment isn't completed
• err_rating_can_not_be_blank — no rating is set
• err_feedback_can_not_be_blank — feedback is mandatory and empty
• err_question_not_found — an answer names a question this scorecard doesn't have
• err_invalid_answer — an answer doesn't fit its question type, or a mandatory question is unanswered
• err_feedback_too_long — feedback is over 65,535 bytes
• 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