GRgreenhouse
Scorecard Candidate Attributes

Updates scorecard candidate attributes

Deprecated — where available, prefer the nested candidate_attributes array on PATCH /v3/scorecards/{id}, which updates ratings by job_candidate_attribute_id with no row ids needed. This endpoint remains fully supported for existing integrations. 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}

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/scorecard_candidate_attributes/{id}
  • Auth
    • OAuth 2
      Authorization code: https://auth.greenhouse.io/authorize
      Client credentials
      Token URL: https://auth.greenhouse.io/token scopes: harvest:scorecard_candidate_attributes:update
    • or HTTP bearer

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.

valuestring

Read-only alias of candidate_attribute_rating, in the same vocabulary the nested write path accepts (candidate_attributes[].value on POST/PATCH /v3/scorecards). A rating cleared with value: null reads back as no_decision.

Changes

No recorded changes to this operation across all 1 revision of this API.