Skip to main content
GET
/
dispositions
cURL
curl --request GET \
  --url https://api.bolna.ai/dispositions/ \
  --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.

Query Parameters

​
agent_id
string<uuid>

If provided, returns only dispositions linked to this agent.

Response

List of dispositions

​
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"