AgentLine Voice API

openapi: 3.2.0
info:
  title: Agentline Cloud Voice API
  version: 0.3.0
  x-refined-note:
  - x-guidance differs across the merged source definitions and was not carried
  description: 'Operations tagged Voice across 2 of this provider''s published API definitions: agentline.cloud_openapi.json, agentline-cloud-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.agentline.cloud
  description: Production
tags:
- name: Voice
paths:
  /v1/account/voice:
    get:
      tags:
      - Voice
      summary: Get Account Voice
      description: 'Get the current account-level default voice for AI phone agents.


        Returns which voice is used for all AI agents under this account

        unless overridden at the agent level or per-call. Controls how

        your AI agents sound during phone conversations.'
      operationId: get_account_voice
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - API Key or OAuth: []
      x-fern-sdk-group-name:
      - voice
      x-fern-sdk-method-name: get
    delete:
      tags:
      - Voice
      summary: Reset Account Voice
      description: 'Reset account voice to the system default.


        Removes the account-level voice override so all AI agents fall back

        to the system default voice during phone calls (unless they have

        their own voice_id configured).'
      operationId: reset_account_voice
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - API Key or OAuth: []
      x-fern-sdk-group-name:
      - voice
      x-fern-sdk-method-name: reset
    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: []
      x-fern-sdk-group-name:
      - voice
      x-fern-sdk-method-name: set
    servers:
    - url: https://api.agentline.cloud
      description: Production
  /v1/voices:
    get:
      tags:
      - Voice
      summary: Get Available Voices
      description: 'List all available voice presets for AI phone agents.


        Returns named TTS (text-to-speech) voice presets that can be used

        when configuring AI agents or making phone calls. Each voice defines

        how your AI agent sounds on the phone.


        You can use a preset name (e.g. "female-1", "male-1") or pass any

        valid Cartesia voice UUID directly as a voice_id.'
      operationId: list_available_voices
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-fern-sdk-group-name:
      - voice
      x-fern-sdk-method-name: list
      security:
      - API Key or OAuth: []
    servers:
    - url: https://api.agentline.cloud
      description: Production
components:
  schemas:
    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
    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.
    VoiceSettingUpdate_2:
      properties:
        voice_id:
          type: string
          title: Voice Id
          description: 'Default voice for the account: a preset_name such as ''female-1'' or a voice_id UUID, both listed by list_available_voices.'
      type: object
      required:
      - voice_id
      title: VoiceSettingUpdate
      description: Set account-level default voice.
  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
x-refined-from:
- agentline.cloud_openapi.json
- agentline-cloud-openapi.json