---
title: "Update Response"
method: PUT
path: "/responses/{response_id}"
tags: ["responses"]
---

# Update Response

`PUT /responses/{response_id}`

## Path parameters

- `response_id` string, uuid, required

## Request body

- union
  - SubmittedResponseUpdate
    - `values` object, required
    - `status` 'submitted', required
  - DiscardedResponseUpdate
    - `values` object, nullable
    - `status` 'discarded', required
  - DraftResponseUpdate
    - `values` object, nullable
    - `status` 'draft', required

## Response `200`

Successful Response

- Response
  - `id` string, uuid, required
  - `values` object, nullable
  - `status` 'draft' | 'submitted' | 'discarded', required
  - `record_id` string, uuid, required
  - `user_id` string, uuid, required
  - `inserted_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

## Changes

- **2026-08-24** `ca32894f988c` — 9 breaking, 3 info
  - removed `subschema #6, subschema #7` from the `oneOf[subschema #1: SubmittedResponseUpdate]/values/additionalProperties/value` request property `anyOf` list
  - removed `subschema #6, subschema #7` from the `oneOf[subschema #2: DiscardedResponseUpdate]/values/anyOf[subschema #1]/additionalProperties/value` request property `anyOf` list
  - removed `subschema #6, subschema #7` from the `oneOf[subschema #3: DraftResponseUpdate]/values/anyOf[subschema #1]/additionalProperties/value` request property `anyOf` list
  - removed the enum value `discarded` of the request property `oneOf[subschema #2: DiscardedResponseUpdate]/status`
  - …8 more
- **2026-08-08** `e9da3a893a88` — 3 info
  - added `subschema #7` to the `oneOf[subschema #1: SubmittedResponseUpdate]/values/additionalProperties/value` request property `anyOf` list
  - added `subschema #7` to the `oneOf[subschema #2: DiscardedResponseUpdate]/values/anyOf[subschema #1]/additionalProperties/value` request property `anyOf` list
  - added `subschema #7` to the `oneOf[subschema #3: DraftResponseUpdate]/values/anyOf[subschema #1]/additionalProperties/value` request property `anyOf` list

[Change history](https://skmtc.dev/hf/apis/extralit-v1/changes/responses/:response_id/put.md)

---

[API](https://skmtc.dev/hf/apis/extralit-v1.md) · [All operations](https://skmtc.dev/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/ca32894f988c/schema)
