---
title: "Answer Language Hold"
method: POST
path: "/runs/{run_id}/language"
---

# Answer Language Hold

`POST /runs/{run_id}/language`

## Request

- Base URL: `https://www.clipzyn.com/v1`
- URL: `https://www.clipzyn.com/v1/runs/{run_id}/language`
- Auth: HTTP bearer

Answer a run parked at the language checkpoint and resume it.

A run whose status is ``awaiting_language`` stopped before any selection and waits
for the account owner to name the episode language; ``language_hold.candidates`` on
GET /v1/runs/{run_id} lists the codes the checkpoint heard. Send one ISO 639-3 code
here (the same write the app's checkpoint makes) and the run is re-dispatched with
the payload it parked with. THIS CALL SPENDS NO QUOTA: the quota was taken when the
run was created, and the resumed run keeps it. Idempotent in effect: the store
accepts one answer while the hold is open, so a second call answers
validation_error (the checkpoint is closed); poll GET /v1/runs/{run_id}/progress.
run_not_found for an unknown or foreign run; validation_error for an unsupported
code or a run that is not parked; service_unavailable when the durable close could
not be written (nothing was dispatched; the hold stays open; retry).

## Path parameters

- `run_id` string, required

## Request body

- LanguageAnswerRequest: The owner's answer to a run parked at the language checkpoint.
  - `language` string, required: The episode language as an ISO 639-3 code, one of ``language_hold.candidates`` on the parked run (or any supported code).

## Response `200`

Successful Response

- LanguageAnswerResponse: What the language door did: the close and the resume, named.
  - `run_id` string, required
  - `language` string, required
  - `revision` integer, nullable
  - `resume_status` string, nullable: ``dispatched`` or ``already_dispatched`` when the run is back in the queue; ``refused`` with ``resume_refusal`` when the close was saved but the resume could not be dispatched (the hold stays answered; poll the run).
  - `resume_refusal` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipzyn/apis/clipzyn-api.md) · [All operations](https://skmtc.dev/clipzyn/apis/clipzyn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipzyn/apis/clipzyn-api/revisions/a0f30a836536?raw)