Skip to main content
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
  }'

{
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Update Advanced Settings

Toggle advanced agent features. Currently the only advanced setting is enable_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

​
agent_id
string
required
Agent UUID.

​
Request Headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request Body

​
enable_initial_message_cache
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
  }'

​
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: true on an ineligible agent fails with 422.
  • Disabling the cache (false) is always allowed.