---
title: "Save transcript, translation and pronunciation edits"
method: PATCH
path: "/v1/dub/jobs/{job_id}/editor"
tags: ["Dub"]
---

# Save transcript, translation and pronunciation edits

`PATCH /v1/dub/jobs/{job_id}/editor`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/dub/jobs/{job_id}/editor`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Save draft text without generating audio or changing current subtitles. Include the latest revision to prevent overwriting another tab. A revision mismatch returns 409 dub_edit_conflict. No delivery units are charged.

## Path parameters

- `job_id` string, required

## Request body

- DubEdits
  - `revision` integer, required
  - `edits` object[], required
    - `id` string, required
    - `source_text` string
    - `translated_text` string
    - `pronunciation_text` string

## Response `200`

Updated saved editor with a new revision number.

- DubEditor
  - `job_id` string, required
  - `revision` integer, required
  - `parent_job_id` string, nullable, required
  - `segments` DubPassage[], required
    - `source_text` string, required
    - `translated_text` string, required
    - `pronunciation_text` string, required: Optional full spoken passage. Empty uses the translation. Subtitles retain the displayed translation.
    - `id` string, required
    - `speaker` string, required
    - `start` number, required
    - `end` number, required
    - `output_start` number, required
    - `output_end` number, required
    - `rendered` DubPassageText, required
      - `source_text` string, required
      - `translated_text` string, required
      - `pronunciation_text` string, required: Optional full spoken passage. Empty uses the translation. Subtitles retain the displayed translation.
    - `changed` boolean, required

## Other responses

- `400`: dub_invalid_edit: invalid text or passage.
- `401`: Missing or invalid API key (`code: unauthorized`)
- `402`: Billing gate: org out of prepaid credit, per-key budget hit, or plan quota exhausted (`code: credit_exhausted | key_budget_exceeded | insufficient_quota`). Do not retry; add credit or raise the limit. A brand-new key may see this on its first call until the account is funded.
- `403`: The product key lacks dub:render.
- `404`: unknown_job: no matching job in the calling organization.
- `409`: dub_edit_conflict or dub_editor_unavailable.
- `429`: Rate/concurrency limit or dub_busy. Retry with backoff.
- `503`: Dubbing is unavailable. Retry with backoff.

---

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