Update agent

PATCH

https://api.levrage.ai/v1/agents/:agent_id

PATCH

/v1/agents/:agent_id

import requests
url = "https://api.levrage.ai/v1/agents/agent_id"
payload = {
    "description": "Updated agent for premium loan products",
    "ai_model": "lai-premium-3",
    "voice": "male"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Sales Agent",
    "language": "English",
    "agent_type": "sales",
    "description": "Updated agent for premium loan products",
    "custom_description": null,
    "sector": "Finance & Banking",
    "tone": "professional",
    "agent_role": "Sales Agent",
    "ai_model": "lai-premium-3",
    "voice": "male",
    "voice_id": null,
    "accent": null,
    "pronunciations": null,
    "voice_response_settings": {
      "listening_sensitivity": 0.5,
      "wait_before_responding": 200,
      "silence_to_end_turn": 300,
      "allow_user_to_interrupt": true,
      "words_to_interrupt": 2,
      "min_response_wait": 0.15,
      "max_response_wait": 0.3,
      "fast_response": true,
      "voice_detection_sensitivity": 0.5,
      "quick_response_padding": 200,
      "turn_end_silence": 300,
      "vad_type": "server_vad",
      "eagerness": "medium",
      "remind_on_silence": true,
      "silence_before_reminder": 10,
      "max_reminders": 3,
      "custom_reminder_messages": null,
      "detect_ivr_systems": true,
      "enable_dtmf_input": false,
      "leave_voicemail": false,
      "max_call_duration_minutes": 15,
      "greeting_delay": 0,
      "call_analysis_enabled": true,
      "immediate_transfer": false,
      "response_creativity": 0.8,
      "turn_detection": "vad"
    },
    "prompt": "You are an AI sales agent for Acme Finance.",
    "start_flow": "Hello! I'm calling from Acme Finance.",
    "end_flow": "Thank you for your time! Have a great day.",
    "details_to_collect": [],
    "brand_name": "Acme Finance",
    "typed_knowledge": null,
    "timezone": "Asia/Kolkata",
    "other_languages": [
      "Hindi"
    ],
    "webhook_config": {
      "url": "https://api.yourcompany.com/webhooks/levrage",
      "events": [
        "call.completed"
      ]
    },
    "custom_api": [],
    "lookup_api": null,
    "transfer_map": [],
    "is_active": true,
    "created_at": "2026-01-15T09:30:00+05:30",
    "updated_at": "2026-01-15T10:15:00+05:30"
  },
  "request_id": "req_f6e5d4c3b2a1",
  "timestamp": "2026-01-15T10:15:00+05:30",
  "success": true
}

Update an existing agent's configuration.

Only provided fields will be updated. Omitted fields remain unchanged.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

agent_idstringRequired

Request

This endpoint expects an object.

namestring or nullOptional>=1 character

Agent name

descriptionstring or nullOptional>=1 character

Agent description

custom_descriptionstring or nullOptional>=1 character

Custom agent description

languagestring or nullOptional>=1 character

Agent language: English, Hindi, Tamil, etc.

sectorstring or nullOptional>=1 character

Industry sector

tonestring or nullOptional>=1 character

Agent tone: professional, friendly, casual, formal

agent_rolestring or nullOptional>=1 character

Agent role

ai_modelstring or nullOptional>=1 character

AI model: lai-premium-2, lai-premium-3, lai-premium-4

voicestring or nullOptional>=1 character

Voice gender: male or female

voice_idstring or nullOptional>=1 character

Voice ID

accentstring or nullOptional>=1 character

Voice accent

pronunciationsmap from strings to strings or nullOptional

Custom pronunciations

voice_response_settingsobject or nullOptional

Voice & response settings

background_sounds_enabledboolean or nullOptional

Office background sound during calls; its volume is voice_response_settings.background_sound_volume

promptstring or nullOptional>=1 character

Agent prompt/instructions

start_flowstring or nullOptional>=1 character

Opening greeting

end_flowstring or nullOptional>=1 character

Closing message

details_to_collectlist of any or nullOptional

Details to collect

brand_namestring or nullOptional>=1 character

Brand name

typed_knowledgestring or nullOptional>=1 character

Knowledge base text

timezonestring or nullOptional>=1 character

Timezone

knowledge_base_idslist of strings or nullOptional

The FULL list of knowledge bases the agent searches; [] detaches all

webhook_configobject or nullOptional

Webhook config

custom_apilist of objects or nullOptional

Custom API configs

lookup_apiobject or nullOptional

Lookup API config

transfer_maplist of objects or nullOptional

Transfer map

other_languageslist of strings or nullOptional

Additional languages

conversation_flow_idstring or nullOptional

A call flow of yours (GET /v1/flows) for the agent to follow; "" turns the flow off

Response

Successful Response

dataobject

Full agent detail response.

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error