Create Call Intent
Create a call intent for an agent.
Call intents are the reasons a caller reached out — “billing question”, “cancel subscription”. Calls are classified into one of them when AI intent detection is enabled.
Authorizations
Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.
Path Parameters
Tuner's internal numeric ID for the agent.
Workspace ID. Find this in Workspace > General Settings.
Body
Input schema for call intent.
Response
Successful Response
Response schema for call intent.
Unique identifier for the call intent.
8
Display name for this intent, shown on call records and filters.
"Billing question"
What the AI matches against when classifying calls. Be specific — vague descriptions produce unreliable classification.
"The caller has a question about a charge on their invoice."