---
title: "Update Agent"
method: PATCH
path: "/api/v1/agents/{id}/"
tags: ["AgentService"]
---

# Update Agent

`PATCH /api/v1/agents/{id}/`

## Path parameters

- `id` string, required

## Request body

- UpdateAgentRequest
  - `widget_settings_id` string
  - `name` string
  - `agent_name` string
  - `model` string
  - `s2s_model` string
  - `voice_id` string
  - `temperature` number, double
  - `reminder_trigger_ms` integer
  - `reminder_max_count` integer
  - `ambient_sound` string
  - `ambient_sound_volume` number, double
  - `end_call_after_silence` boolean
  - `max_call_duration_ms` integer
  - `ring_duration_ms` integer
  - `enable_voicemail_detection` boolean
  - `voicemail_message` string
  - `voicemail_detection_timeout_ms` integer
  - `enable_emergency_fallback` boolean
  - `emergency_fallback_number` string
  - `ivr_options` object
  - `post_call_analysis_model` string
  - `analysis_summary_prompt` string
  - `selected_tools` object
  - `integrations` object
  - `knowledge_base` string
  - `begin_message` string
  - `start_speaker` string

## Response `200`

Successful response

- UpdateAgentResponse
  - `success` boolean
  - `message` string
  - `data` Agent
    - `id` string — Unique agent ID
    - `organization_id` string — Organization this agent belongs to
    - `widget_settings_id` string — Associated widget settings ID
    - `name` string — Internal name of the agent
    - `agent_name` string — Display name of the agent
    - `status` 'AGENT_STATUS_UNSPECIFIED' | 'AGENT_STATUS_ACTIVE' | 'AGENT_STATUS_INACTIVE' — Status of the agent
    - `model` string — LLM model identifier
    - `s2s_model` string — Speech-to-speech model identifier
    - `voice_id` string — Voice ID for TTS
    - `temperature` number, double — LLM temperature setting
    - `reminder_trigger_ms` integer — Milliseconds before sending a reminder
    - `reminder_max_count` integer — Maximum number of reminders to send
    - `ambient_sound` string — Ambient sound identifier
    - `ambient_sound_volume` number, double — Volume of ambient sound (0.0 - 1.0)
    - `end_call_after_silence` boolean — Whether to end the call after silence
    - `max_call_duration_ms` integer — Maximum call duration in milliseconds
    - `ring_duration_ms` integer — Ring duration in milliseconds
    - `enable_voicemail_detection` boolean — Whether to enable voicemail detection
    - `voicemail_message` string — Message to leave on voicemail
    - `voicemail_detection_timeout_ms` integer — Voicemail detection timeout in milliseconds
    - `enable_emergency_fallback` boolean — Whether to transfer the call to a backup number on failure
    - `emergency_fallback_number` string — The backup number to transfer the call to
    - `ivr_options` object — IVR (Interactive Voice Response) configuration
    - `post_call_analysis_model` string — Model to use for post-call analysis
    - `analysis_summary_prompt` string — Prompt used for generating call summary
    - `selected_tools` object — Tools selected for this agent
    - `integrations` object — Integration configuration
    - `knowledge_base` string — Knowledge base content or reference
    - `begin_message` string — Opening message spoken by the agent
    - `start_speaker` string — Who speaks first: agent or user
    - `created_at` string — Creation timestamp
    - `updated_at` string — Last update timestamp

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/versions/48f45dc58534/schema)