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

# Get a saved voice

> Get one voice saved in the current workspace library, including its current availability.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/voices/{voice_id}
openapi: 3.1.0
info:
  title: Threetone API
  description: >-
    APIs for the Threetone Agents Platform and shared workspace resources.
    Authenticate programmatic requests with an API key in the x-api-key header.
  version: '1.0'
servers:
  - url: https://api.threetone.in
    description: Production
security: []
paths:
  /v1/voices/{voice_id}:
    get:
      tags:
        - Voices
      summary: Get a saved voice
      description: >-
        Get one voice saved in the current workspace library, including its
        current availability.
      operationId: voices_get
      parameters:
        - name: voice_id
          in: path
          required: true
          schema:
            type: string
            title: Voice Id
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Your API key for programmatic access. Send it in the x-api-key
              header; you can create and manage keys from the Developers page.
            title: X-Api-Key
          description: >-
            Your API key for programmatic access. Send it in the x-api-key
            header; you can create and manage keys from the Developers page.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceListItem'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/HTTPValidationError'
                  - $ref: '#/components/schemas/APIErrorResponse'
                title: Response 422 Voices Get
        default:
          description: >-
            API error. Depending on the operation: 400 invalid request, 401
            authentication required, 402 insufficient credits, 403 permission
            denied, 404 resource not found, 409 conflict, 429 rate limit, 500
            internal failure, 502 upstream failure, 503 service unavailable, or
            504 upstream timeout. A failed response does not establish whether a
            state-changing operation completed; do not retry such operations
            without checking their outcome.
          headers:
            X-Request-Id:
              description: Request identifier, when available.
              schema:
                type: string
            Retry-After:
              description: >-
                When supplied, the delay in seconds or HTTP date before a
                subsequent request.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse'
components:
  schemas:
    VoiceListItem:
      properties:
        voice_id:
          type: string
          title: Voice Id
        name:
          type: string
          title: Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        gender:
          anyOf:
            - type: string
            - type: 'null'
          title: Gender
        accent:
          anyOf:
            - type: string
            - type: 'null'
          title: Accent
        is_saved:
          type: boolean
          title: Is Saved
        available:
          type: boolean
          title: Available
        variants:
          items:
            $ref: '#/components/schemas/VoiceModelVariant'
          type: array
          title: Variants
      type: object
      required:
        - voice_id
        - name
        - is_saved
        - available
        - variants
      title: VoiceListItem
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    APIErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/APIErrorDetail'
      type: object
      required:
        - detail
      title: APIErrorResponse
    VoiceModelVariant:
      properties:
        model_id:
          type: string
          title: Model Id
        variant_id:
          type: string
          title: Variant Id
        model_name:
          type: string
          title: Model Name
        provider_key:
          type: string
          title: Provider Key
        provider_name:
          type: string
          title: Provider Name
        is_default:
          type: boolean
          title: Is Default
        languages:
          items:
            $ref: '#/components/schemas/VoiceLanguage'
          type: array
          title: Languages
      type: object
      required:
        - model_id
        - variant_id
        - model_name
        - provider_key
        - provider_name
        - is_default
        - languages
      title: VoiceModelVariant
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    APIErrorDetail:
      properties:
        status:
          type: string
          title: Status
          description: >-
            Stable application error identifier, separate from the HTTP status
            code.
        message:
          type: string
          title: Message
          description: Customer-facing explanation of the error.
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
          description: Request identifier for support and troubleshooting, when available.
      additionalProperties: true
      type: object
      required:
        - status
        - message
      title: APIErrorDetail
      description: Public error fields; domains may supply additional customer-safe detail.
    VoiceLanguage:
      properties:
        language_tag:
          type: string
          title: Language Tag
        name:
          type: string
          title: Name
        preview_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Preview Id
      type: object
      required:
        - language_tag
        - name
      title: VoiceLanguage

````

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