> ## Documentation Index > Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Correct transcript words > Correct what a clip's transcript says, one or more words at a time (at most 100 per request). Each edit addresses a word by its transcript `index` and sets either `text` (the corrected wording, which also unhides the word) or `hidden` (whether the word appears in captions and subtitles). Edits change the transcript, captions and subtitles only — never the audio or the clip's timing; use cut-by-transcript to remove spoken words from the video. Visibility and wording are independent: hiding a word preserves any correction made to it. The whole batch is applied atomically as a single transaction, so a request never changes only some of its words. A `500` does not by itself mean nothing changed — the words can land and a later step of the commit still fail — so treat the outcome as either fully applied or not applied at all. Every edit assigns a word outright, so re-sending the identical request is safe and settles it. ## OpenAPI ````yaml /openapi.json patch /v1/videos/{id}/clips/{clipId}/transcript/words openapi: 3.0.3 info: description: >- The Tella Public API allows you to programmatically access your videos and playlists, including transcripts, chapters, and thumbnails. ## Authentication All requests require a Bearer token in the Authorization header: ``` Authorization: Bearer tella_pk_xxxxx... ``` API keys can be generated in your Tella workspace settings. ## Rate Limiting The API is rate-limited to 100 requests per minute per organization. Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests per window - `X-RateLimit-Remaining`: Remaining requests in current window - `X-RateLimit-Reset`: Unix timestamp when the window resets title: Tella Public API version: 1.0.0 servers: - description: Production url: https://api.tella.com security: [] tags: - description: Video operations name: Videos - description: Sections of a video name: Clips - description: Playlist operations name: Playlists - description: Sidebar groups for organizing playlists name: Playlist Groups - description: Tags for categorizing and filtering videos name: Tags - description: Personal, workspace, and default video backgrounds name: Backgrounds - description: >- Reusable media saved to a workspace, plus Tella's curated sound effect catalog — the same items the editor's media panels show name: Library - description: Webhook endpoint management name: Webhooks paths: /v1/videos/{id}/clips/{clipId}/transcript/words: patch: tags: - Clips summary: Correct transcript words description: >- Correct what a clip's transcript says, one or more words at a time (at most 100 per request). Each edit addresses a word by its transcript `index` and sets either `text` (the corrected wording, which also unhides the word) or `hidden` (whether the word appears in captions and subtitles). Edits change the transcript, captions and subtitles only — never the audio or the clip's timing; use cut-by-transcript to remove spoken words from the video. Visibility and wording are independent: hiding a word preserves any correction made to it. The whole batch is applied atomically as a single transaction, so a request never changes only some of its words. A `500` does not by itself mean nothing changed — the words can land and a later step of the commit still fail — so treat the outcome as either fully applied or not applied at all. Every edit assigns a word outright, so re-sending the identical request is safe and settles it. operationId: updateClipTranscriptWords parameters: - description: Video identifier in: path name: id required: true schema: description: Video identifier example: vid_abc123def456 type: string - description: Clip identifier in: path name: clipId required: true schema: description: Clip identifier example: cl_xyz789ghi012 type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateClipTranscriptWordsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/UpdateClipTranscriptWordsResponse' description: OK '400': $ref: '#/components/responses/400ErrorResponse' '401': $ref: '#/components/responses/401ErrorResponse' '403': $ref: '#/components/responses/403ErrorResponse' '404': $ref: '#/components/responses/404ErrorResponse' '422': $ref: '#/components/responses/422ErrorResponse' '429': $ref: '#/components/responses/429ErrorResponse' '500': $ref: '#/components/responses/500ErrorResponse' security: - BearerAuth: [] components: schemas: UpdateClipTranscriptWordsRequest: additionalProperties: false description: >- Correct what the transcript says. Word edits change the transcript, captions and subtitles only — they never change the audio or the clip's timing. Use cut-by-transcript to remove spoken words from the video. The whole batch is applied atomically, so a request never changes only some of its words. A `500` does not by itself mean nothing changed — the words can land and a later step of the commit still fail — so treat the outcome as either fully applied or not applied at all, and re-send the identical request to settle it; every edit assigns a word outright, so re-sending is safe. properties: words: description: >- Word edits to apply, at most one per word index and at most 100 per request. Indices are stable across cuts, but a word that is currently cut out of the clip cannot be edited. items: $ref: '#/components/schemas/TranscriptWordEdit' maxItems: 100 minItems: 1 type: array required: - words type: object UpdateClipTranscriptWordsResponse: additionalProperties: false description: The words that were edited, after the edit. properties: words: description: The edited words in their new state, in the order they were sent. items: $ref: '#/components/schemas/TranscriptWord' type: array required: - words type: object TranscriptWordEdit: additionalProperties: false description: >- A correction to a single transcript word, addressed by its transcript index. Set exactly one of `text` or `hidden`. maxProperties: 2 minProperties: 2 properties: hidden: description: >- `true` hides the word from captions and subtitles without touching the audio; `false` shows it again. A correction already made to the word is preserved. example: true type: boolean index: description: Index of the word to edit, as reported by the clip's transcript. example: 12 maximum: 9007199254740991 minimum: 0 type: integer text: description: >- Corrected text for the word. Replaces what the transcript, captions and subtitles say, and unhides the word. Must not be empty — hide a word with `hidden` instead. example: Tella minLength: 1 type: string required: - index type: object TranscriptWord: additionalProperties: false description: A single transcribed word properties: endTimeMs: description: Word end time, in ms on the clip's playback timeline example: 1800 minimum: 0 type: number hidden: description: Whether the word is hidden by an edit example: false type: boolean index: description: Stable index of the word in the source recording example: 12 maximum: 9007199254740991 minimum: 0 type: integer startTimeMs: description: Word start time, in ms on the clip's playback timeline example: 1500 minimum: 0 type: number text: description: Word text example: Hello type: string required: - index - startTimeMs - endTimeMs - text - hidden type: object ErrorResponse: additionalProperties: false description: Standard error response format properties: error: additionalProperties: false description: Error details properties: code: description: Machine-readable error code enum: - bad_request - unauthorized - forbidden - not_found - unprocessable_entity - rate_limit_exceeded - internal_server_error example: not_found type: string doc_url: description: Link to documentation for this error example: https://tella.tv/docs/api-reference/errors#not-found format: uri type: string message: description: Human-readable error message example: The requested resource was not found. type: string required: - code - message - doc_url type: object required: - error type: object responses: 400ErrorResponse: content: application/json: example: error: code: bad_request doc_url: https://tella.tv/docs/api-reference/errors#bad-request message: The request was malformed or contained invalid parameters. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was malformed or contained invalid parameters. 401ErrorResponse: content: application/json: example: error: code: unauthorized doc_url: https://tella.tv/docs/api-reference/errors#unauthorized message: Authentication is required. Provide a valid API key. schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication is required. Provide a valid API key. 403ErrorResponse: content: application/json: example: error: code: forbidden doc_url: https://tella.tv/docs/api-reference/errors#forbidden message: You don't have permission to access this resource. schema: $ref: '#/components/schemas/ErrorResponse' description: You don't have permission to access this resource. 404ErrorResponse: content: application/json: example: error: code: not_found doc_url: https://tella.tv/docs/api-reference/errors#not-found message: The requested resource was not found. schema: $ref: '#/components/schemas/ErrorResponse' description: The requested resource was not found. 422ErrorResponse: content: application/json: example: error: code: unprocessable_entity doc_url: https://tella.tv/docs/api-reference/errors#unprocessable-entity message: The request was well-formed but contained semantic errors. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was well-formed but contained semantic errors. 429ErrorResponse: content: application/json: example: error: code: rate_limit_exceeded doc_url: https://tella.tv/docs/api-reference/errors#rate-limit-exceeded message: You have exceeded the rate limit. Please slow down. schema: $ref: '#/components/schemas/ErrorResponse' description: You have exceeded the rate limit. Please slow down. 500ErrorResponse: content: application/json: example: error: code: internal_server_error doc_url: https://tella.tv/docs/api-reference/errors#internal-server-error message: An unexpected error occurred on the server. schema: $ref: '#/components/schemas/ErrorResponse' description: An unexpected error occurred on the server. securitySchemes: BearerAuth: description: API key obtained from your Tella account settings scheme: bearer type: http ```` ## Related topics - [Cut clip ranges by transcript word indices](/docs/api-reference/clips/cut-clip-ranges-by-transcript-word-indices.md) - [Model Context Protocol (MCP)](/docs/mcp-server.md) - [Style subtitles](/docs/help/editing/style-subtitles.md) - [Find & replace subtitles](/docs/help/editing/find-replace-subtitles.md) - [Edit with the transcript](/docs/help/editing/edit-the-transcript-of-a-tella-video.md)