Skip to main content

​
GET /dispositions/{disposition_id}

Returns a single disposition by ID.

​
Path Parameters

ParameterTypeRequiredDescription
disposition_idUUIDYesThe ID of the disposition to retrieve

​
Query Parameters

ParameterTypeRequiredDescription
agent_idstringNoIf provided, returns the disposition only if it is linked to this agent

​
Response

Returns a single Disposition object.

​
Examples

curl --request GET \
  --url 'https://api.bolna.dev/dispositions/{disposition_id}?agent_id={agent_id}' \
  --header 'Authorization: Bearer {api_key}'

​
Response Example

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Agent Handover Needed",
  "question": "Did the customer explicitly ask to speak with a human agent?",
  "system_prompt": "",
  "category": "Escalation",
  "model": "gpt-4.1-mini",
  "is_subjective": false,
  "is_objective": true,
  "objective_options": [
    { "value": "Yes", "condition": "Customer asked to speak with a human or live agent" },
    { "value": "No", "condition": "Customer did not request a human handover" }
  ],
  "agent_ids": ["agt_abc123"],
  "created_by": "user_abc123",
  "created_at": "2026-03-01T10:00:00Z",
  "updated_at": "2026-03-15T14:30:00Z"
}

​
Error Responses

StatusDescription
403Access denied — disposition or agent does not belong to your account
404Disposition not found
500Internal server error