Skip to main content
PUT
Upsert agent

Notes

  • Create a new agent or update existing one
  • Auto-generates ID if not provided
  • Returns operation type (“created” or “updated”) in response

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Body

application/json
agent_name
string
required
agent_id
string
organization_id
string
created_at
string<date-time>
updated_at
string<date-time>
begin_message
string
begin_message_variables
string[]
begin_message_delay_ms
integer<int32>
test_variables
object
webhook_url
string
post_call_webhook_id
string
end_call_after_silence_ms
integer<int32>
max_call_duration_ms
integer<int32>
take_turn_after_silence_seconds
number<double>
timezone
string
knowledge_base_ids
string[]
mcp_server_ids
string[]
rag_config
object
llm_config
object
stt_config
object
tts_config
object
post_call_analysis_data
object[]
post_call_analysis_model
string
post_call_evaluation_criteria
object[]
widget_config
object
access_info
object
fetch_webhook_data
boolean
use_rag
boolean
integrations
string[]
text_only
boolean
additional_languages
object[]

Response

Agent created or updated successfully

message
string
status
string
error
string | null
data
object