---
title: "Update Voice Agent"
method: PUT
path: "/voice_agents/voice-agents/{voice_agent_id}"
tags: ["voice_agents"]
---

# Update Voice Agent

`PUT /voice_agents/voice-agents/{voice_agent_id}`

## Path parameters

- `voice_agent_id` string, uuid, required

## Request body

- VoiceAgentUpdateData — Request model for updating a voice agent.
  - `name` string, required
  - `inbound_config` VoiceAgentInboundConfigUpsert, required
    - `is_enabled` boolean, required
  - `outbound_config` VoiceAgentOutboundConfigUpsertAPI, required
    - `phone_number_field` PhoneNumberFieldInput, required
      - `type` 'phone_number'
      - `user_field_name` string, required
    - `data_schema` StringFieldInput[], required
      - `type` 'string'
      - `user_field_name` string, required
    - `is_enabled` boolean, required
    - `outbound_auto_retry_configs` VoiceAgentOutboundAutoRetryConfigUpsert[], required
      - `name` string, required
      - `settings` VoiceAgentOutboundAutoRetryConfigSettings, required
        - `base_max_attempts` integer, required
        - `schedule` AutoRetryScheduleWeekly, required
          - `type` 'weekly'
          - `monday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `tuesday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `wednesday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `thursday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `friday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `saturday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
          - `sunday` TimePeriod[]
            - `day` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required
            - `hour` integer, required
            - `minute` integer, required
      - `id` string, uuid, nullable
    - `outbound_config_integration_relations` IntegrationVoiceAgentOutboundConfigRelationUpsertAPI[], required
      - `integration_id` string, uuid, required
      - `status` 'DISABLED' | 'CREATE_BATCH' | 'CREATE_RUN', required — Enum for integration outbound config relation status.
  - `voice_platform` 'livekit', nullable — Voice platform provider ('livekit'). Omit field to keep current value.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/voice_agents/voice-agents/:voice_agent_id/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/704de2d43c75?raw)