Skip to main content
POST
/
dispositions
/
bulk
cURL
curl --request POST \
  --url https://api.bolna.ai/dispositions/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "dispositions": [
    {
      "name": "Agent Handover Needed",
      "question": "Did the customer explicitly ask to speak with a human agent?",
      "category": "Escalation",
      "system_prompt": "<string>",
      "model": "gpt-4.1-mini",
      "is_subjective": false,
      "is_objective": false,
      "subjective_type": "text",
      "objective_options": [
        {
          "value": "interested",
          "condition": "Customer expressed genuine interest and agreed to a next step",
          "sub_options": "<array>"
        }
      ]
    }
  ]
}
'
{
  "message": "Dispositions created successfully",
  "ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "7cb91a23-1234-4321-b2fc-1c963f11bde4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use bulk create when setting up a new agent with a complete set of dispositions, or when importing a disposition configuration from another source. Either all dispositions are created and linked, or none are — partial results are not possible.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Bulk-create dispositions for an agent.

Request body for atomically creating multiple dispositions linked to an agent.

​
agent_id
string<uuid>
required

The agent all dispositions will be linked to.

​
dispositions
object[]
required

Non-empty array of disposition objects to create.

Minimum array length: 1

Response

Dispositions created successfully

Response returned after a successful bulk-create. The ids array preserves the input order.

​
message
string
Example:

"Dispositions created successfully"

​
ids
string<uuid>[]

IDs of the newly created dispositions, in the same order as the input dispositions array.

Example:
[
  "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "7cb91a23-1234-4321-b2fc-1c963f11bde4"
]