---
title: "Update Transcription Text"
description: "Edit the official transcript text of a single media file by finding and replacing text."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Transcription Text

Use the Speak AI MCP server tool `update_transcription` to edit the official
transcript text of a single media file by finding and replacing text.

## What does it do?

Edit the official transcript text of a single media file by finding and replacing
text. Replaces every occurrence of the original text with the replacement (leave
replacement empty to delete the text) and reports how many occurrences were
replaced. Use `update_transcript_speakers` to rename speaker labels instead.

## Parameters

`update_transcription` takes 4 parameters, 3 of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `mediaId` | string | Yes | Unique identifier of the media file |
| `original` | string | Yes | Text to find in the transcript |
| `replacement` | string | Yes | Text to replace it with (empty string deletes the matched text) |
| `caseSensitive` | boolean | No | Match case exactly when finding the original text |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `update_transcription`.

- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Media library](/mcp/tools/media/) lists the rest of the Media library category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/media/update_transcription/index.mdx