curl -X PATCH "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"enable_initial_message_cache": true
}'
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
enable_initial_message_cache: true
})
});
const result = await response.json();
{
"success": true,
"message": "Advanced settings updated successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "SupportBot",
"advanced_settings": {
"enable_initial_message_cache": true
},
"updated_at": "2024-01-15T11:00:00Z"
}
}
Agents
Update Advanced Settings
Toggle agent features such as optimized cost caching
PATCH
/
api
/
v1
/
agents
/
{agent_id}
/
advanced-settings
curl -X PATCH "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"enable_initial_message_cache": true
}'
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
enable_initial_message_cache: true
})
});
const result = await response.json();
{
"success": true,
"message": "Advanced settings updated successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "SupportBot",
"advanced_settings": {
"enable_initial_message_cache": true
},
"updated_at": "2024-01-15T11:00:00Z"
}
}
Update Advanced Settings
Toggle agent features. Currently the only setting isenable_initial_message_cache, which activates optimized cost pricing once the agent meets the eligibility threshold.
Endpoint
PATCH /api/v1/agents/{agent_id}/advanced-settings
Path parameters
string
required
Agent UUID.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
boolean
When
true, enables caching of the agent’s initial message audio for repeated outbound calls. Reduces voice synthesis cost per call. Requires the agent to be eligible — see Check Optimized Costs Eligibility.Examples
curl -X PATCH "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"enable_initial_message_cache": true
}'
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/advanced-settings', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
enable_initial_message_cache: true
})
});
const result = await response.json();
Response
{
"success": true,
"message": "Advanced settings updated successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "SupportBot",
"advanced_settings": {
"enable_initial_message_cache": true
},
"updated_at": "2024-01-15T11:00:00Z"
}
}
Error responses
422 Not Eligible
{
"success": false,
"message": "Agent does not meet the call volume threshold for optimized costs",
"code": "OPTIMIZED_COSTS_NOT_ELIGIBLE",
"details": {
"current_calls": 312,
"required_calls": 700,
"threshold_days": 7
}
}
Notes
- Eligibility is enforced server-side. Toggling
enable_initial_message_cache: trueon an ineligible agent fails with422. - Disabling the cache (
false) is always allowed.
Was this page helpful?