---
title: "Changes to Creates a new transcription from either a sourceId or a mediaUrl. Either sourceId or mediaUrl must be provided, but not both."
method: POST
path: "/v3/Transcriptions"
---

# Changes to Creates a new transcription from either a sourceId or a mediaUrl. Either sourceId or mediaUrl must be provided, but not both.

`POST /v3/Transcriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 5 revisions.

- **2026-10-12** (v3) `df2bdba2dcf0`: 21 breaking
- **2026-09-09** (v3) `c98e4be22d70`: 2 info
- **2026-08-11** (v3) `084846095e82`: 1 info

## Changes

- **2026-10-12** (v3) `df2bdba2dcf0`: 21 breaking
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `400`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `401`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `403`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `404`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `422`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `429`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `500`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `400`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `401`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `403`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `404`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `422`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `429`
  - the `errors/items/detail` response property's minLength was decreased from `16` to `0` for the response status `500`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `400`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `401`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `403`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `404`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `422`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `429`
  - the `title` response property's minLength was decreased from `16` to `0` for the response status `500`
- **2026-09-09** (v3) `c98e4be22d70`: 2 info
  - the request property `oneOf[#/components/schemas/voice.v3.transcription.CreateRequestWithMediaUrl]/mediaUrl` became optional
  - added the optional property `transcription/links` to the response with the `202` status
- **2026-08-11** (v3) `084846095e82`: 1 info
  - added the non-success response with the status `404`

---

[Operation](https://skmtc.dev/twilio/apis/twilio-voice/docs/v3/Transcriptions/post.md) - [API](https://skmtc.dev/twilio/apis/twilio-voice.md) - [Page](https://skmtc.dev/twilio/apis/twilio-voice/changes/v3/Transcriptions/post)