VoiceDto

Public representation of a voice. A stable client contract, decoupled from internal storage.

idstring

Unique identifier for the voice.

Example: 7Hb2Kp9QvL3mNx0R8tZ4

created_atdate-time

Timestamp when the voice was created.

Example: 2026-01-15T09:30:00Z

updated_atdate-time

Timestamp when the voice was last updated.

Example: 2026-01-15T09:30:00Z

podcast_idstring

Identifier of the podcast this voice belongs to.

Example: 7Hb2Kp9QvL3mNx0R8tZ4

titlestringnullable

Display name of the voice.

Example: Morning Host

descriptionstringnullable

Short description of the voice.

Example: Warm, conversational host voice for morning episodes.

statusstring

Lifecycle status; a voice is 'ready' once it has audio samples

Possible values: [pending, ready, archived, failed]

Example: ready

verification_statusstring

Whether the voice has been verified for use

Possible values: [pending, verified, rejected]

Example: verified

info object

Additional voice metadata, including language and uploaded samples.

languagestringnullable

Primary language of the voice as an ISO 639-1 code.

Example: en

files object[]

The uploaded audio samples backing this voice.

Array [

filenamestringnullable

Stored filename of the audio sample.

Example: sample-001.mp3

original_namestringnullable

Original filename of the sample as uploaded by the client.

Example: morning-host-take-1.mp3

sizeint64nullable

Size of the audio sample in bytes.

Example: 204800

]

VoiceDto

{
  "id": "7Hb2Kp9QvL3mNx0R8tZ4",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "podcast_id": "7Hb2Kp9QvL3mNx0R8tZ4",
  "title": "Morning Host",
  "description": "Warm, conversational host voice for morning episodes.",
  "status": "ready",
  "verification_status": "verified",
  "info": {
    "language": "en",
    "files": [
      {
        "filename": "sample-001.mp3",
        "original_name": "morning-host-take-1.mp3",
        "size": 204800
      }
    ]
  }
}