Skip to main content
PATCH
/
v1
/
voices
/
{id}
/
samples
Update Voice Sample Transcriptions
curl --request PATCH \
  --url https://api.bland.ai/v1/voices/{id}/samples \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "samples": [
    {}
  ]
}
'
{
  "status": "success",
  "samples": [
    {
      "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
      "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
      "transcription": "Hello and welcome to Bland.",
      "duration_seconds": 11.4,
      "created_at": "2026-06-22T21:34:31.347Z"
    }
  ]
}

​
Overview

Updates the transcribed text for one or more samples on a voice clone you own. Useful when auto-transcription has errors that you want to correct before the voice is used. The samples themselves and their audio are not modified.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the parent voice.

​
Body Parameters

​
samples
array
required
Array of sample updates. Each entry must include id and transcription.
{
  "samples": [
    { "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a", "transcription": "Hello and welcome to Bland." }
  ]
}

​
Response

​
status
string
success on success.
​
samples
array
The updated samples. See List Voice Samples for field shape.
{
  "status": "success",
  "samples": [
    {
      "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
      "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
      "transcription": "Hello and welcome to Bland.",
      "duration_seconds": 11.4,
      "created_at": "2026-06-22T21:34:31.347Z"
    }
  ]
}
Docs for agents: llms.txt