Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

disposition_id
string<uuid>
required

The ID of the disposition to retrieve.

Query Parameters

agent_id
string<uuid>

If provided, returns the disposition only if it is linked to this agent.

Response

Disposition found

An LLM-powered post-call classifier that labels call outcomes from transcripts.

id
string<uuid>

Unique identifier for the disposition.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

name
string

Display name shown in results.

Example:

"Call Outcome"

question
string

The prompt sent to the LLM to evaluate the transcript.

Example:

"What was the outcome of the call?"

system_prompt
string | null

Optional system context for the LLM.

Example:

"You are analyzing a sales call transcript."

category
string
default:General

Grouping label for the disposition.

Example:

"Lead Quality"

model
string
default:gpt-4.1-mini

LLM model used for evaluation.

Example:

"gpt-4.1-mini"

is_subjective
boolean
default:false

Enables free-text response.

Example:

true

is_objective
boolean
default:false

Enables pre-defined value selection.

Example:

true

subjective_type
enum<string>
default:text

Format constraint for free-text responses. Only allowed when is_subjective is true.

Available options:
text,
timestamp,
numeric,
boolean,
email,
regex
subjective_type_config
object | null

Configuration for the regex subjective type. Required when subjective_type is regex.

objective_options
object[] | null

Pre-defined options. Required when is_objective is true.

agent_ids
string[]

List of agent IDs this disposition is linked to.

Example:
created_by
string

ID of the user who created this disposition.

Example:

"user_abc123"

created_at
string<date-time>

ISO timestamp when the disposition was created.

Example:

"2026-03-01T10:00:00Z"

updated_at
string<date-time>

ISO timestamp when the disposition was last updated.

Example:

"2026-03-15T14:30:00Z"