Update scorecard

patch

https://harvest.greenhouse.io/v3/scorecards/{id}

Patch an existing scorecard. The body replaces values wholesale on the fields it includes — sending a new notes value overwrites the previous one rather than appending. Set status to complete to submit a draft scorecard (this stamps submitted_at and ends the edit window for non-admin users). Editing submitted scorecards is governed by the organization's scorecard-edit permissions: Site Admins can edit any time, while Job Admins are bound by the 30-day edit window.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

Body Params

interviewer_id

integer

required

Id of the Greenhouse user this scorecard is assigned to (the interviewer being scored against).

interviewed_at

date-time

required

Timestamp the interview took place, in ISO 8601.

notes

string

Free-text "key takeaways" (pros, cons, follow-ups). Replaces the existing value wholesale.

candidate_rating

string

enum

Overall recommendation. One of strong_no ("Definitely Not"), no, yes, strong_yes, or no_decision.

Allowed:

private_notes

string

Free-text private notes; only readers with the "see private notes" permission see these. Replaces the existing value wholesale.

status

string

enum

Lifecycle status. Move a draft to complete to submit (Greenhouse stamps submitted_at on transition). Site Admins can edit submitted scorecards at any time; Job Admins are bound by the organization's scorecard-edit window.

Allowed:

public_notes

string

Free-text "note to other interviewers". Replaces the existing value wholesale.

submitter_id

integer

required

Id of the user submitting (or last editing) the scorecard. Usually matches interviewer_id.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful