> ## Documentation Index
> Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List available voices

> Retrieves all available Text-to-Speech (TTS) voices for your organization including
both public voices and custom cloned voices. Each voice includes metadata such as
language, gender, description, and audio preview URLs for agent configuration.

## Voice Categories

**Public Voices**:

* Pre-trained voices available to all users
* Wide variety of languages, accents, and characteristics

**Cloned Voices**:

* Custom voices created from audio samples
* Organization-specific and private

## Voice Selection

Consider these factors when selecting a voice:

* **Language**: Match your target audience's language
* **Characteristics**: Gender, age, accent, tone
* **Quality**: Audio clarity and naturalness
* **Performance**: Latency and real-time suitability


## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice
openapi: 3.0.4
info:
  title: Dasha BlackBox Agent API
  description: API for managing AI agents and calls
  contact:
    name: DashaAI Team
    email: support@dasha.ai
  version: v1
servers:
  - url: https://blackbox.dasha.ai
    description: Dasha BlackBox Agent API
security:
  - ApiKey: []
  - OAuth: []
tags:
  - name: ActivityLogs
  - name: Agents
  - name: AgentTestCases
  - name: CallResults
  - name: Calls
  - name: Chats
  - name: Copilot
  - name: CustomerData
  - name: Mcp
  - name: Media
  - name: Misc
  - name: PronunciationDictionaries
  - name: Providers
  - name: SipAliases
  - name: SipCredentials
  - name: SipPhoneNumbers
  - name: TextChat
  - name: TwilioProvider
  - name: Voice
  - name: WebhookTest
  - name: WebIntegrations
  - name: WebSocket
    description: WebSocket endpoints for real-time communication
paths:
  /api/v1/voice:
    get:
      tags:
        - Voice
      summary: List available voices
      description: >-
        Retrieves all available Text-to-Speech (TTS) voices for your
        organization including

        both public voices and custom cloned voices. Each voice includes
        metadata such as

        language, gender, description, and audio preview URLs for agent
        configuration.
      responses:
        '200':
          description: Returns available voices successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TtsCloneResponseDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Access denied to voice resources
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred while retrieving voices
components:
  schemas:
    TtsCloneResponseDto:
      required:
        - category
        - id
        - provider
      type: object
      properties:
        id:
          minLength: 1
          type: string
          description: Unique identifier for the voice
        name:
          type: string
          description: Display name of the voice
          nullable: true
        voiceId:
          type: string
          description: Voice ID used for synthesis
          nullable: true
        provider:
          minLength: 1
          type: string
          description: >-
            TTS provider used for this voice. Supported providers: ElevenLabs,
            Cartesia, Lmnt.
        description:
          type: string
          description: Description of voice characteristics
          nullable: true
        language:
          type: string
          description: Primary language for the voice
          nullable: true
        labels:
          type: object
          additionalProperties:
            type: string
          description: Custom metadata labels
          nullable: true
        previewUrl:
          type: string
          description: URL for voice preview audio
          nullable: true
        category:
          allOf:
            - $ref: '#/components/schemas/TtsVoiceCategory'
          description: >-
            Voice category. Public voices are provided by the TTS provider,
            Cloned voices are custom voices created through voice cloning.
        createdTime:
          type: string
          description: Timestamp when voice was created
          format: date-time
          nullable: true
        lastUpdatedTime:
          type: string
          description: Timestamp when voice was last updated
          format: date-time
          nullable: true
      additionalProperties: false
      description: Response DTO for TTS voice cloning operations
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    TtsVoiceCategory:
      enum:
        - Public
        - Cloned
      type: string
      description: Voice category classification
  securitySchemes:
    ApiKey:
      type: http
      description: API Key Authentication (Bearer {key})
      scheme: Bearer
    OAuth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://auth.dasha.ai/connect/authorize
          scopes:
            platform_api: Platform API

````