Skip to main content

​
GET /dispositions/

Returns a list of dispositions. Supports two modes depending on whether agent_id is provided.

​
Query Parameters

ParameterTypeRequiredDescription
agent_idstringNoIf provided, returns only dispositions linked to this agent. If omitted, returns all your own dispositions.

​
Response

Returns an array of Disposition objects.

​
Examples

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

​
Response Example

[
  {
    "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,
    "objective_options": [
      { "value": "interested", "condition": "Customer agreed to a next step" },
      { "value": "not_interested", "condition": "Customer declined all proposals" }
    ],
    "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 — agent_id does not belong to your account
500Internal server error