curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Agents
Check Optimized Costs Eligibility
Check whether an agent qualifies for optimized cost pricing
GET
/
api
/
v1
/
agents
/
{agent_id}
/
optimized-costs-eligibility
curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Check Optimized Costs Eligibility
Check whether an agent qualifies for optimized cost pricing. Optimized costs apply caching to repeated agent prompts and reduce per-call cost — eligibility is based on call volume over a recent window.Endpoint
GET /api/v1/agents/{agent_id}/optimized-costs-eligibility
Path parameters
string
required
Agent UUID.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
Response
Eligible
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Not Eligible
{
"success": true,
"data": {
"eligible": false,
"current_calls": 312,
"required_calls": 700,
"threshold_days": 7,
"calls_remaining": 388
}
}
Response fields
boolean
required
Whether the agent currently meets the volume threshold for optimized costs.
integer
required
Number of calls placed by this agent in the last
threshold_days days.integer
required
Volume threshold required for eligibility.
integer
required
Window size in days used to count calls.
Notes
- Once eligible, enable optimized costs via Update Advanced Settings by setting
enable_initial_message_cache: true. - Eligibility is checked in real time — keep polling this endpoint or check periodically.
- Agents that drop below the threshold may be reverted to standard pricing automatically.
Was this page helpful?