---
title: "Add Dubbing Transcript Segment"
method: POST
path: "/v1/dubbing/project/{project_id}/transcript/segment"
tags: ["Dubbing"]
---

# Add Dubbing Transcript Segment

`POST /v1/dubbing/project/{project_id}/transcript/segment`

Enterprise only. Add a new source segment to the transcript. Its span must lie within the source media, last between 0.1 and 25 seconds, and not overlap another segment by the same speaker. Bumps the project's `revision`, discards the affected translations in every language target, and marks any target that had already completed `stale`. No audio changes until you regenerate a target.

## Path parameters

- `project_id` string, required — Identifier of the dubbing project.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- DubbingSegmentCreateRequest — A new source segment; its ID and word-level alignment are assigned by the server.
  - `text` string, required — The text of the new segment.
  - `speaker_id` string, required — Identifier of the segment's speaker.
  - `start_s` number, required — Start time of the segment, in seconds.
  - `end_s` number, required — End time of the segment, in seconds.

## Response `201`

Successful Response

- DubbingSourceSegmentUpdateResponse — The result of a source-segment add or edit: the segment and the new revision.
  - `segment` DubbingTranscriptSegment, required — One segment of a source transcript.
    - `id` string, required — Stable identifier of the segment, used to address it in edit requests.
    - `text` string, required — The transcribed text of the segment.
    - `speaker_id` string, required — Identifier of the segment's speaker.
    - `start_s` number, required — Start time of the segment, in seconds.
    - `end_s` number, required — End time of the segment, in seconds.
    - `external_id` string, nullable — The caller-supplied external ID for this segment, if one was provided.
  - `revision` integer, required — The project's source-transcript revision after this edit.

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-31** `72c54eba117e` — 1 info
  - added the optional property `segment/external_id` to the response with the `201` status

[Change history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/dubbing/project/:project_id/transcript/segment/post.md)

---

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