---
title: "Update scorecard question answer"
method: PATCH
path: "/v3/scorecard_question_answers/{id}"
tags: ["Scorecard Question Answers"]
deprecated: true
---

# Update scorecard question answer

`PATCH /v3/scorecard_question_answers/{id}`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/scorecard_question_answers/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:scorecard_question_answers:update`
  - HTTP bearer

> **Deprecated.**

**Deprecated** — where available, prefer the nested `question_answers` array on `PATCH /v3/scorecards/{id}`, which updates answers by `scorecard_question_id` with no answer-row ids needed. This endpoint remains fully supported for existing integrations. Update an existing scorecard question answer in place. Only the response fields (`answer` for `text` questions, `boolean_value` for `yes_no` questions) can be changed; the `scorecard_id` / `scorecard_question_id` linkage is immutable and sending either is rejected as a disallowed property. Sending the wrong field for the question's `answer_type` returns a 422.

## Path parameters

- `id` integer, required

## Request body

- object
  - `answer` string, nullable: Updated free-text response for `text`-type questions. Send `null` or an empty string to clear the answer. Rejected with a 422 if the underlying question's `answer_type` is not `text`.
  - `boolean_value` boolean, nullable: Updated response for `yes_no`-type questions: `true` for yes, `false` for no, `null` to clear. Rejected with a 422 (`Cannot update boolean value for non-boolean question.`) if the underlying question's `answer_type` is not `yes_no`.

## Response `200`

Successful

- object
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `scorecard_id` integer: Id of the scorecard this answer belongs to. Every answer is tied to exactly one scorecard, which in turn belongs to a single interviewer's submission on one application.
  - `scorecard_question_id` integer: Id of the `scorecard_question` this answer responds to. The question's `answer_type` (`text`, `yes_no`, `single_select`, `multi_select`) determines which field on the answer is populated: `text` uses `answer`, `yes_no` uses `boolean_value`, and `single_select`/`multi_select` use the `scorecard_question_answer_options` sub-resource.
  - `answer` string, nullable: Free-text response for `text`-type scorecard questions. Plain text — HTML formatting and `@`-mention markup are stripped. `null` (or empty string) when the question is `yes_no`, `single_select`, or `multi_select`, or when the interviewer declined to answer.
  - `answer_with_tags` string, nullable: HTML-formatted version of `answer`, preserving rich-text formatting (bold, italic, etc.) and `@`-mentions as embedded user tags (e.g. `@[User Name](user:123)`). `null` when there is no formatting or markup to preserve (i.e. when the stored value would be identical to `answer`), and under the same conditions as `answer`.
  - `boolean_value` boolean, nullable: Response for `yes_no`-type scorecard questions: `true` for yes, `false` for no, `null` when the question is not `yes_no` or when the interviewer left it blank. Ignored on writes for any question whose `answer_type` is not `yes_no`.
  - `value` union: Read-only. The answer in the same vocabulary the nested write path accepts (`question_answers[].value` on `POST`/`PATCH /v3/scorecards`), dispatched on the question's `answer_type`: string for `text`, boolean for `yes_no`, the selected option id for `single_select`, an array of selected option ids for `multi_select`. `null` when unanswered.
    - string
    - boolean
    - integer
    - integer[]

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)