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

# List Narration Voices

> The full course-generation narration roster (Train 2): all ten
VOICE_ROSTER personas, white-labeled -- `id` is what the create paths'
`voice` field and this file's PUT .../voice accept; the underlying
Google TTS voice name never appears in this response (config.
VOICE_ROSTER_BY_ID[id]["google_voice"] is an internal detail only).
`live` marks the five personas ALSO selectable on the live voice picker
(GET /api/v1/voice/voices, VA3); the other five are narration-only.
`default` marks config.VOICE_ROSTER_DEFAULT_ID. `preview_urls` is a
per-language dict (config.NARRATION_PREVIEW_LANGUAGES keys); a language
with no recorded clip yet is null, never a dead link (D4).



## OpenAPI

````yaml /openapi.yaml get /api/v1/voices
openapi: 3.1.0
info:
  title: Mahara Platform
  description: >
    AI Sales Training Course Generator, a Coursera-style platform.


    ## Authentication


    Every request must carry your API key as a Bearer token:


    `Authorization: Bearer sk_live_your_key_here`


    ## Getting an API key


    API keys are provisioned by our team. They are not self-service, so there is
    no signup page to apply on. To request access, email **sales@myustadia.com**
    and we will issue a key for your account.
  version: 1.0.0
servers: []
security: []
paths:
  /api/v1/voices:
    get:
      tags:
        - B2B Narration Voices
      summary: List Narration Voices
      description: |-
        The full course-generation narration roster (Train 2): all ten
        VOICE_ROSTER personas, white-labeled -- `id` is what the create paths'
        `voice` field and this file's PUT .../voice accept; the underlying
        Google TTS voice name never appears in this response (config.
        VOICE_ROSTER_BY_ID[id]["google_voice"] is an internal detail only).
        `live` marks the five personas ALSO selectable on the live voice picker
        (GET /api/v1/voice/voices, VA3); the other five are narration-only.
        `default` marks config.VOICE_ROSTER_DEFAULT_ID. `preview_urls` is a
        per-language dict (config.NARRATION_PREVIEW_LANGUAGES keys); a language
        with no recorded clip yet is null, never a dead link (D4).
      operationId: list_narration_voices_api_v1_voices_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/NarrationVoice'
                type: array
                title: Response List Narration Voices Api V1 Voices Get
components:
  schemas:
    NarrationVoice:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          type: string
          title: Description
        description_fr:
          type: string
          title: Description Fr
        gender:
          type: string
          title: Gender
        live:
          type: boolean
          title: Live
        default:
          type: boolean
          title: Default
        preview_urls:
          additionalProperties:
            anyOf:
              - type: string
              - type: 'null'
          type: object
          title: Preview Urls
      type: object
      required:
        - id
        - name
        - description
        - description_fr
        - gender
        - live
        - default
        - preview_urls
      title: NarrationVoice

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.