Skip to main content
GET
/
dispositions
/
{disposition_id}
cURL
curl --request GET \
  --url https://api.bolna.ai/dispositions/{disposition_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Call Outcome",
  "question": "What was the outcome of the call?",
  "system_prompt": "You are analyzing a sales call transcript.",
  "category": "Lead Quality",
  "model": "gpt-4.1-mini",
  "is_subjective": true,
  "is_objective": true,
  "subjective_type": "text",
  "subjective_type_config": {
    "pattern": "^\\d{10}$",
    "description": "10-digit phone number"
  },
  "objective_options": [
    {
      "value": "interested",
      "condition": "Customer expressed genuine interest and agreed to a next step",
      "sub_options": "<array>"
    }
  ],
  "agent_ids": [
    "agt_abc123"
  ],
  "created_by": "user_abc123",
  "created_at": "2026-03-01T10:00:00Z",
  "updated_at": "2026-03-15T14:30:00Z"
}

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

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:
["agt_abc123"]
​
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"