Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Scorecard Candidate Attributes

Updates scorecard candidate attributes

Update an existing attribute rating in place. Only candidate_attribute_rating and note can be changed; the scorecard_id / job_candidate_attribute_id linkage is immutable and sending either is rejected as a disallowed property. The underlying scorecard must still be editable — submitted scorecards reject attribute-rating updates.

patch/v3/scorecard_candidate_attributes/{id}

Path parameters

idinteger required

Request body

candidate_attribute_rating'definitely_not' | 'no' | 'yes' | 'strong_yes' | 'mixed' | 'no_decision'

New rating for this attribute. One of definitely_not, no, yes, strong_yes, mixed, or no_decision. The scorecard_id / job_candidate_attribute_id linkage is immutable — to move a rating to a different attribute, delete and recreate the row.

notestring

New free-text note for this attribute. Replaces the previous note wholesale.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
scorecard_idinteger

Id of the scorecard this attribute rating belongs to. One row per (scorecard, attribute) pair — the interviewer rated this candidate on this attribute on this scorecard.

candidate_attribute_ratingstring

Interviewer's rating for the attribute on this scorecard. One of definitely_not, no, yes, strong_yes, mixed, or no_decision. no_decision is recorded when the row exists (e.g. a note was left) but no rating was selected.

job_candidate_attribute_idinteger

Id of the job's job_candidate_attribute being rated (the per-job attribute catalogue entry on /v3/job_candidate_attributes). The attribute's display name and candidate_attribute_type live on that record.

notestring nullable

Free-text note the interviewer left for this attribute (e.g. a brief justification for the rating). null when no note was provided.