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

# Update Account Voice

> Set the account-level default voice for AI phone agents.

This becomes the default voice for ALL AI agents under this account,
controlling how they sound on phone calls. Individual agents or
specific calls can still override this setting.

Voice resolution priority:
  1. Per-call voice_id (POST /v1/calls)
  2. Agent voice_id (PATCH /v1/agents/{id})
  3. Account default (this endpoint)  ← you are here
  4. System default (Supportive Male)

Accepts:
  - A preset name: "female-1", "female-2", "female-3", "male-1", "male-2", "male-3"
  - A Cartesia voice UUID: "f786b574-daa5-4673-aa0c-cbe3e8534c02"



## OpenAPI

````yaml /openapi.json patch /v1/account/voice
openapi: 3.1.0
info:
  title: AgentLine
  description: >-
    AgentLine gives every AI agent a real US phone number and a human-like
    voice. Agents can make and receive calls and receive SMS. This spec covers
    the core developer surface: agents, numbers, calls, messages, events,
    webhooks, billing, and voice.
  version: 0.3.0
  summary: US phone numbers and voice for AI agents. Inbound SMS can be read.
  contact:
    name: AgentLine
    url: https://agentline.cloud
  license:
    name: MIT
    url: https://opensource.org/license/mit
servers:
  - url: https://api.agentline.cloud
    description: Production
security:
  - API Key or OAuth: []
paths:
  /v1/account/voice:
    patch:
      tags:
        - Voice
      summary: Update Account Voice
      description: |-
        Set the account-level default voice for AI phone agents.

        This becomes the default voice for ALL AI agents under this account,
        controlling how they sound on phone calls. Individual agents or
        specific calls can still override this setting.

        Voice resolution priority:
          1. Per-call voice_id (POST /v1/calls)
          2. Agent voice_id (PATCH /v1/agents/{id})
          3. Account default (this endpoint)  ← you are here
          4. System default (Supportive Male)

        Accepts:
          - A preset name: "female-1", "female-2", "female-3", "male-1", "male-2", "male-3"
          - A Cartesia voice UUID: "f786b574-daa5-4673-aa0c-cbe3e8534c02"
      operationId: set_account_voice
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceSettingUpdate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - API Key or OAuth: []
components:
  schemas:
    VoiceSettingUpdate:
      properties:
        voice_id:
          type: string
          title: Voice Id
          description: >-
            TTS voice preset name (e.g. 'female-1', 'male-1') or Cartesia voice
            UUID
      type: object
      required:
        - voice_id
      title: VoiceSettingUpdate
      description: Set account-level default voice.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    API Key or OAuth:
      type: http
      description: >-
        AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp
        then POST /v1/auth/verify). Pass as: Authorization: Bearer al_live_...
        (legacy sk_live_... still works).
      scheme: bearer
      bearerFormat: API key (al_live_...)
      x-fern-bearer:
        name: apiKey
        env: AGENTLINE_API_KEY

````

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