> ## Documentation Index > Fetch the complete documentation index at: https://docs.maybloc.com/llms.txt > Use this file to discover all available pages before exploring further. # Rename a transcript or its speakers > Renames the transcript, or names its speakers with speaker_names, for example {"speaker_1": "Ana"}. The names appear on the transcript, in exports and in generated add-on text. ## OpenAPI ````yaml PATCH /transcripts/{id} openapi: 3.1.0 info: title: Maybloc API version: 1.0.0 description: >- Speech-to-text for recorded audio. Upload a recording and get back a transcript with every speaker separated, overlapping speech kept, and every word timed. servers: - url: https://app.maybloc.com/api/v1 description: Maybloc v1 security: - bearerAuth: [] tags: - name: Uploads description: Send a recording straight to private storage. - name: Transcripts description: Transcribe recordings and read the results. - name: Account description: Your workspace and its balance. paths: /transcripts/{id}: patch: tags: - Transcripts summary: Rename a transcript or its speakers description: >- Renames the transcript, or names its speakers with speaker_names, for example {"speaker_1": "Ana"}. The names appear on the transcript, in exports and in generated add-on text. operationId: updateTranscript parameters: - $ref: '#/components/parameters/TranscriptId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateTranscriptRequest' responses: '200': description: The updated transcript content: application/json: schema: $ref: '#/components/schemas/Transcript' '400': description: Invalid name content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Read-only API key content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Transcript not found content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: TranscriptId: name: id in: path required: true schema: type: string format: uuid schemas: UpdateTranscriptRequest: type: object properties: file_name: type: string minLength: 1 maxLength: 255 speaker_names: type: object description: Names keyed by speaker id. An empty string removes a name. additionalProperties: type: string maxLength: 60 Transcript: type: object properties: id: type: string format: uuid object: type: string const: transcript model: type: string status: type: string enum: - queued - processing - completed - failed - canceled file_name: type: string speaker_names: type: object additionalProperties: type: string config: $ref: '#/components/schemas/RunConfig' duration_ms: type: integer error: type: - string - 'null' description: Why it failed or was canceled. cost: type: object properties: currency: type: string const: usd estimated_micro_usd: type: integer description: Held from your balance when the transcript is created. charged_micro_usd: type: - integer - 'null' description: >- Set when it completes. Failed and canceled transcripts are not charged. created_at: type: string format: date-time completed_at: type: - string - 'null' format: date-time Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string examples: - invalid_request - insufficient_credit - rate_limited message: type: string request_id: type: string description: Quote this when contacting support. RunConfig: type: object additionalProperties: false description: >- How the transcript is made. Unknown fields are rejected. The playground's Export config writes this object. properties: model: type: string enum: - calico-1-flash default: calico-1-flash language: type: string enum: - auto - en - es - fr - de - it - pt - nl - pl - ru - uk - tr - ar - fa - he - hi - ur - bn - ta - te - mr - gu - pa - kn - ml - zh - ja - ko - th - vi - id - ms - tl - sv - da - 'no' - fi - cs - ro - hu - el - bg - hr - sk - sl - sr default: auto description: >- ISO 639-1 code of the spoken language, or auto to detect one language for the recording. addons: type: array uniqueItems: true items: type: string enum: - redact_pii - smart_format - subtitles - insights - identify_speakers - sentiment - topics - keywords - custom_fields - translation description: >- Made from the transcript and priced per minute on top of the model: redact_pii (PII redaction, +$0.0005/min), smart_format (Smart formatting, +$0.0005/min), subtitles (Subtitles, free), insights (Insights, +$0.001/min), identify_speakers (Speaker names, +$0.0005/min), sentiment (Sentiment, +$0.0005/min), topics (Topics and entities, +$0.0005/min), keywords (Key terms, +$0.0005/min), custom_fields (Custom fields, +$0.0005/min), translation (Translation, +$0.0015/min per language). translate_to: type: array uniqueItems: true maxItems: 5 items: type: string enum: - en - es - fr - de - it - pt - nl - pl - ru - uk - tr - ar - fa - he - hi - ur - bn - ta - te - mr - gu - pa - kn - ml - zh - ja - ko - th - vi - id - ms - tl - sv - da - 'no' - fi - cs - ro - hu - el - bg - hr - sk - sl - sr description: >- With translation: 1 to 5 languages to translate into, each charged per minute. custom_fields: type: array maxItems: 20 items: $ref: '#/components/schemas/CustomField' description: 'With custom_fields: 1 to 20 questions answered from the recording.' CustomField: type: object required: - key - question properties: key: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: Names the answer in the result. question: type: string maxLength: 500 type: type: string enum: - text - number - boolean - list - speaker - choice default: text description: >- boolean is yes or no; speaker answers with a speaker id; choice answers with one of options. options: type: array items: type: string minItems: 2 maxItems: 50 description: With type choice. securitySchemes: bearerAuth: type: http scheme: bearer description: 'An API key: Authorization: Bearer mbk_live_...' ```` ## Related topics - [How to authenticate Maybloc API requests](https://docs.maybloc.com/authentication.md) - [What does a Maybloc transcript result contain?](https://docs.maybloc.com/guides/results.md) - [Maybloc API documentation](https://docs.maybloc.com/index.md) - [Retrieve a transcript](https://docs.maybloc.com/api-reference/retrieve-a-transcript.md) - [Create a transcript](https://docs.maybloc.com/api-reference/create-a-transcript.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.