Skip to main content
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"
{
  "success": true,
  "data": {
    "eligible": true,
    "current_calls": 842,
    "required_calls": 700,
    "threshold_days": 7
  }
}

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.

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

agent_id
string
required
Agent UUID.

Request Headers

Authorization
string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

Examples

curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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

data.eligible
boolean
required
Whether the agent currently meets the volume threshold for optimized costs.
data.current_calls
integer
required
Number of calls placed by this agent in the last threshold_days days.
data.required_calls
integer
required
Volume threshold required for eligibility.
data.threshold_days
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.