HomeGuidesExamplesAPI ReferenceChangelog
Log InWistia Learning CenterWistia
API Reference
Wistia Learning CenterWistia

Edit Captions Text

post
https://api.wistia.com/modern/medias//captions//edits

Applies targeted find-and-replace corrections to a media's transcript for
the specified language, preserving the timings of unchanged words. The whole
batch is applied atomically against a specific caption version, or nothing is.

Requires api token with one of the following permissions

Read, update & delete anything

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An expiring access token
created with the all:delegate_to_contact_permissions scope and an
authorization granting the edit-transcripts permission on this media can
also be used. When the media is a composite whose captions belong to
another media, the token also needs edit-transcripts on that media.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requestsā€¦
LoadingLoadingā€¦
Path Params
string
required

The hashed ID of the media whose transcript should be edited.

string
required

The 3-character ISO 639-2 language code of the caption track to edit (e.g., eng, fra, spa). Some languages use extended IETF subtags (e.g., zh-Hant).

Body Params
edits
array of objects
required
length between 1 and 20

The corrections to apply, all-or-nothing, in one new version.

edits*
string
required

The exact transcript text to replace. Matched exactly after normalization (case, punctuation, and whitespace are ignored). Fuzzy matches are never applied ā€” they are only returned as suggestions.

string
required

The text to substitute for the target. Use an empty string to delete the target.

integer

Optional lower bound (inclusive, in the requested media's coordinate space) restricting the match to a time window. Must be sent with end_ms.

integer

Optional upper bound (inclusive) restricting the match to a time window. Must be sent with start_ms.

integer
required

The active caption version returned with the caption content used to prepare these edits. The edit applies only if that is still the active version; otherwise it returns 409 so you re-read and retry.

Headers
string
required
Defaults to 2026-09
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoadingā€¦
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?