List Dispositions API
Retrieve all dispositions accessible to your account via GET /dispositions/, optionally scoped to a specific agent with a query parameter.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
If provided, returns only dispositions linked to this agent.
Response
List of dispositions
Unique identifier for the disposition.
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Display name shown in results.
"Call Outcome"
The prompt sent to the LLM to evaluate the transcript.
"What was the outcome of the call?"
Optional system context for the LLM.
"You are analyzing a sales call transcript."
Name of the extraction category this disposition belongs to. Mirrors the category's name.
"Lead Quality"
ID of the extraction category this disposition belongs to. null for platform-managed dispositions.
"9b2e8f10-4c7d-4e2a-9f31-6a8d5c1b0e42"
LLM model label on the disposition. The extraction pass runs on the category's model.
"gpt-4.1-mini"
Enables free-text response.
true
Enables pre-defined value selection.
true
Format constraint for free-text responses. Only allowed when is_subjective is true.
text, timestamp, numeric, boolean, email, regex Configuration for the regex subjective type. Required when subjective_type is regex.
Pre-defined options. Required when is_objective is true.
List of agent IDs this disposition is linked to.
ID of the user who created this disposition.
"user_abc123"
ISO timestamp when the disposition was created.
"2026-03-01T10:00:00Z"
ISO timestamp when the disposition was last updated.
"2026-03-15T14:30:00Z"

