Skip to main content
POST
Create Call Intent

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

agent_id
integer
required

Tuner's internal numeric ID for the agent.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Body

application/json

Input schema for call intent.

label
string
required

Display name for this intent, shown on call records and filters.

Required string length: 1 - 200
description
string
required

What the AI matches against when classifying calls. Be specific — vague descriptions produce unreliable classification.

Minimum string length: 1

Response

Successful Response

Response schema for call intent.

id
integer
required

Unique identifier for the call intent.

Example:

8

label
string
required

Display name for this intent, shown on call records and filters.

Example:

"Billing question"

description
string
required

What the AI matches against when classifying calls. Be specific — vague descriptions produce unreliable classification.

Example:

"The caller has a question about a charge on their invoice."