Skip to main content
POST
/
dispositions
cURL
curl --request POST \
  --url https://api.bolna.ai/dispositions/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Call Outcome",
  "question": "What was the final outcome of this call?",
  "category": "Lead Quality",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "system_prompt": "<string>",
  "model": "gpt-4.1-mini",
  "is_subjective": true,
  "is_objective": true,
  "subjective_type": "text",
  "objective_options": [
    {
      "value": "interested",
      "condition": "Customer expressed genuine interest and agreed to a next step"
    },
    {
      "value": "not_interested",
      "condition": "Customer declined or was unresponsive to all proposals"
    },
    {
      "value": "follow_up",
      "condition": "Customer asked to be contacted again at a later time"
    }
  ]
}
'
{
  "message": "Disposition created successfully",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
At least one of is_subjective or is_objective must be true. When is_objective is true, you must provide objective_options. See the ObjectiveOption schema for the full structure including nested sub_options.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Disposition to create.

Request body for creating a disposition.

At least one of is_subjective or is_objective must be true. When is_objective is true, objective_options is required and must be non-empty. When subjective_type is regex, subjective_type_config with a pattern is required.

​
name
string
required

Display name shown in results.

Example:

"Call Outcome"

​
question
string
required

The prompt sent to the LLM to evaluate the transcript.

Example:

"What was the final outcome of this call?"

​
category
string
default:General

Grouping label for the disposition.

Example:

"Lead Quality"

​
agent_id
string<uuid>

If provided, links the disposition to this agent on creation.

​
system_prompt
string

Optional system context for the LLM.

​
model
string
default:gpt-4.1-mini

LLM model to use for evaluation.

Example:

"gpt-4.1-mini"

​
is_subjective
boolean
default:false

Enable free-text response.

Example:

true

​
is_objective
boolean
default:false

Enable 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

Required when subjective_type is regex.

​
objective_options
object[]

Required when is_objective is true. Must be non-empty.

Example:
[
  {
    "value": "interested",
    "condition": "Customer expressed genuine interest and agreed to a next step"
  },
  {
    "value": "not_interested",
    "condition": "Customer declined or was unresponsive to all proposals"
  },
  {
    "value": "follow_up",
    "condition": "Customer asked to be contacted again at a later time"
  }
]

Response

Disposition created successfully

Standard response for create/update/delete operations on a single disposition.

​
message
string
Example:

"Disposition created successfully"

​
id
string<uuid>
Example:

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