---
title: "Update Account Voice"
method: PATCH
path: "/v1/account/voice"
tags: ["Voice"]
---

# Update Account Voice

`PATCH /v1/account/voice`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/account/voice`
- Auth: HTTP bearer

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 (make_outbound_call)
  2. Agent voice_id (update_agent)
  3. Account default (this tool)
  4. System default (Supportive Male)

Returns account_id, default_voice_id (as sent) and resolved_voice_id
(the UUID it resolves to). An unknown preset or malformed UUID returns
HTTP 400.

## Request body

- VoiceSettingUpdate: Set account-level default voice.
  - `voice_id` string, required: Default voice for the account: a preset_name such as 'female-1' or a voice_id UUID, both listed by list_available_voices.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)