curl --request PATCH \
--url https://api.callin.io/api/public/v1/agents/{agentId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"success": true,
"data": {
"agentId": "<string>",
"name": "<string>",
"direction": "outbound",
"tags": [
"<string>"
],
"conversationConfig": {
"agent": {
"prompt": {
"prompt": "<string>",
"llm": "gemini-2.5-flash",
"temperature": 0,
"toolIds": [
"<string>"
],
"builtInTools": {
"endCall": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"languageDetection": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"skipTurn": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"transferToAgent": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"transfers": [
{
"agentId": "<string>",
"condition": "<string>",
"delayMs": 123,
"transferMessage": "<string>",
"enableTransferredAgentFirstMessage": true
}
]
},
"transferToNumber": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"transferRuleIds": [
"<string>"
],
"transfers": [
{
"condition": "<string>",
"transferDestination": {
"phoneNumber": "<string>",
"sipUri": "<string>"
}
}
]
},
"voicemailDetection": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"voicemailMessage": "<string>"
}
},
"knowledgeBase": [
"<string>"
],
"ignoreDefaultPersonality": false,
"timezone": "UTC"
},
"greetingMessage": "<string>",
"primaryLanguage": "en",
"hinglishMode": false,
"dynamicVariables": {},
"disableFirstMessageInterruptions": false
},
"asr": {
"userInputAudioFormat": "pcm_16000",
"keywords": [
"<string>"
]
},
"turn": {
"turnTimeout": 7,
"silenceEndCallTimeout": -1,
"turnEagerness": "normal",
"spellingPatience": "auto"
},
"tts": {
"voiceId": "cjVigY5qzO86Huf0OWal",
"supportedVoices": [
{
"label": "<string>",
"voiceId": "<string>",
"language": "<string>",
"stability": 0.5,
"speed": 0.95,
"similarityBoost": 0.5
}
],
"expressiveMode": false,
"suggestedAudioTags": [
{
"tag": "<string>",
"description": "<string>"
}
],
"agentOutputAudioFormat": "pcm_16000",
"optimizeStreamingLatency": 3,
"stability": 0.5,
"speed": 1,
"similarityBoost": 0.8
},
"conversation": {
"maxDurationSeconds": 300
},
"languagePresets": {}
},
"platformSettings": {
"callActions": {
"smartOptOut": false,
"issueTracking": false,
"postCallWebhook": "<string>",
"postCallEmail": {
"enabled": false,
"emailConfiguration": {}
},
"scheduleOnCalendar": {
"enabled": false,
"eventsIds": [
"<string>"
]
}
},
"widget": {},
"dataCollection": {
"entities": {},
"storeData": false
},
"callRetry": {
"retryCount": 123,
"retryDelay": 123
},
"summaryLanguage": "<string>",
"privacy": {
"recordVoice": false
},
"telephony": {
"numberRotationEnabled": false,
"rotationNumbers": [
"<string>"
],
"callsPerNumber": 123,
"stateRestrictionEnabled": false,
"stateRestrictedNumbers": [
"<string>"
]
}
},
"phoneNumbers": [
{
"provider": "<string>",
"number": "<string>",
"label": "<string>"
}
],
"workflow": {
"edges": {},
"nodes": {},
"preventSubagentLoops": false
},
"metadata": {
"createdAt": "<string>",
"updatedAt": "<string>",
"createdBy": {
"userId": "<string>",
"userEmail": "<string>"
}
}
}
}Partially updates an agent. Only fields included in the request body are changed; omitted fields remain unchanged. Returns the full updated agent on success.
curl --request PATCH \
--url https://api.callin.io/api/public/v1/agents/{agentId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"success": true,
"data": {
"agentId": "<string>",
"name": "<string>",
"direction": "outbound",
"tags": [
"<string>"
],
"conversationConfig": {
"agent": {
"prompt": {
"prompt": "<string>",
"llm": "gemini-2.5-flash",
"temperature": 0,
"toolIds": [
"<string>"
],
"builtInTools": {
"endCall": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"languageDetection": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"skipTurn": {
"enabled": true,
"description": "<string>",
"disableInterruption": false
},
"transferToAgent": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"transfers": [
{
"agentId": "<string>",
"condition": "<string>",
"delayMs": 123,
"transferMessage": "<string>",
"enableTransferredAgentFirstMessage": true
}
]
},
"transferToNumber": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"transferRuleIds": [
"<string>"
],
"transfers": [
{
"condition": "<string>",
"transferDestination": {
"phoneNumber": "<string>",
"sipUri": "<string>"
}
}
]
},
"voicemailDetection": {
"enabled": true,
"description": "<string>",
"disableInterruption": false,
"voicemailMessage": "<string>"
}
},
"knowledgeBase": [
"<string>"
],
"ignoreDefaultPersonality": false,
"timezone": "UTC"
},
"greetingMessage": "<string>",
"primaryLanguage": "en",
"hinglishMode": false,
"dynamicVariables": {},
"disableFirstMessageInterruptions": false
},
"asr": {
"userInputAudioFormat": "pcm_16000",
"keywords": [
"<string>"
]
},
"turn": {
"turnTimeout": 7,
"silenceEndCallTimeout": -1,
"turnEagerness": "normal",
"spellingPatience": "auto"
},
"tts": {
"voiceId": "cjVigY5qzO86Huf0OWal",
"supportedVoices": [
{
"label": "<string>",
"voiceId": "<string>",
"language": "<string>",
"stability": 0.5,
"speed": 0.95,
"similarityBoost": 0.5
}
],
"expressiveMode": false,
"suggestedAudioTags": [
{
"tag": "<string>",
"description": "<string>"
}
],
"agentOutputAudioFormat": "pcm_16000",
"optimizeStreamingLatency": 3,
"stability": 0.5,
"speed": 1,
"similarityBoost": 0.8
},
"conversation": {
"maxDurationSeconds": 300
},
"languagePresets": {}
},
"platformSettings": {
"callActions": {
"smartOptOut": false,
"issueTracking": false,
"postCallWebhook": "<string>",
"postCallEmail": {
"enabled": false,
"emailConfiguration": {}
},
"scheduleOnCalendar": {
"enabled": false,
"eventsIds": [
"<string>"
]
}
},
"widget": {},
"dataCollection": {
"entities": {},
"storeData": false
},
"callRetry": {
"retryCount": 123,
"retryDelay": 123
},
"summaryLanguage": "<string>",
"privacy": {
"recordVoice": false
},
"telephony": {
"numberRotationEnabled": false,
"rotationNumbers": [
"<string>"
],
"callsPerNumber": 123,
"stateRestrictionEnabled": false,
"stateRestrictedNumbers": [
"<string>"
]
}
},
"phoneNumbers": [
{
"provider": "<string>",
"number": "<string>",
"label": "<string>"
}
],
"workflow": {
"edges": {},
"nodes": {},
"preventSubagentLoops": false
},
"metadata": {
"createdAt": "<string>",
"updatedAt": "<string>",
"createdBy": {
"userId": "<string>",
"userEmail": "<string>"
}
}
}
}Documentation Index
Fetch the complete documentation index at: https://support.callin.io/llms.txt
Use this file to discover all available pages before exploring further.
Send your Callin API key in the x-api-key header.
The unique identifier of the agent to update.
Partial update payload for an agent. All fields are optional — include only the fields you want to change. Omitted fields remain unchanged.
Display name for the agent.
Supported call direction.
outbound, inbound, both Tags for organizing agents.
Show child attributes
Platform settings fields to update. Only include fields you want to change.
Show child attributes
Was this page helpful?