> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Disposition Draft

> Retrieve a disposition's live draft definition.

### Overview

> [!NOTE]
>
> Dispositions are enabled per organization. If your organization does not have access, these endpoints return `404`.

Returns the editable draft definition and its current `revision`. Send that revision back as `expectedDraftRevision` when you call [Update Disposition Draft](https://docs.bland.ai/api-v2/patch/agents-id-dispositions-disposition-id-draft.md) or [Publish Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-publish.md). Compare the draft against its published base with [Get Disposition Version](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-versions-version-id.md).

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**agent\_id** `string` *required*

The agent's unique identifier. Must be a UUID; otherwise returns `400` with the message `agentId must be a valid UUID`. Returns `404 Agent not found` if the agent is not in your organization.

**disposition\_id** `string` *required*

The disposition's unique identifier. Must be a UUID; otherwise returns `400` with the message `dispositionId must be a valid UUID`. Returns `404 Disposition not found` if it does not belong to this agent.

### Response

**data.dispositionId** `string`

The disposition this draft belongs to.

**data.revision** `number`

The draft's current revision. Every draft update and publish increments it.

**data.baseVersionId** `string | null`

The most recently published version, which is the base this draft is edited against. `null` if the disposition has never been published.

**data.definition** `object`

The draft definition. Same shape as the `definition` body parameter of [Create Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions.md).

**definition object**

**name** `string`

Display name, 1 to 120 characters.

**description** `string`

Free-text description, up to 2000 characters. May be empty.

**timing** `string`

`immediate` or `within_24h`.

**values** `array`

Up to 50 value objects, each with `id`, `key`, `label`, `schema`, and `source`. A `structured_extraction` source that has been through publish also carries a server-written `frozen` copy of the extractor's prompt, output schema, and inference configuration; its `inferenceConfig.modelProfileKey`, when present, is one of `balanced`, `fast`, or `high_accuracy`.

**transformation** `object`

`{ "version": 1, "root": node }`, where the root node assembles the delivered payload from value ids and literals.

**postCallWebhook** `object`

`{ "mode": "hold" }` or `{ "mode": "emit_followup" }`.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "data": {
    "dispositionId": "88b81ef5-3a12-4294-89a1-6cb88f111e05",
    "revision": 4,
    "baseVersionId": "dfc54fe8-59e1-4722-8123-2fc186ea7fd9",
    "definition": {
      "name": "Appointment outcome",
      "description": "Did the caller book, and did they ask for a callback?",
      "timing": "immediate",
      "values": [
        {
          "id": "aab72385-5852-4da8-aeff-703ddfc4105d",
          "key": "booked",
          "label": "Appointment booked",
          "schema": { "kind": "boolean" },
          "source": {
            "kind": "judge",
            "judgeId": "4bddc575-a6b2-4257-b75f-0963b24dd55f",
            "judgeVersionId": "4baad4cc-814b-4555-bbe6-58eeb9611e84",
            "execution": { "reasoningEffort": "auto", "inputSourceIds": ["transcript"] }
          }
        },
        {
          "id": "d6d00a32-836b-4e50-9619-f2d11d988659",
          "key": "callback_time",
          "label": "Requested callback time",
          "schema": {
            "kind": "string",
            "description": "When the caller asked to be called back. Preserve exact character-by-character spelling."
          },
          "source": {
            "kind": "variable_extraction",
            "variableKey": "callback_time",
            "execution": { "reasoningEffort": "auto" }
          }
        }
      ],
      "transformation": {
        "version": 1,
        "root": {
          "kind": "object",
          "fields": {
            "booked": { "kind": "value", "valueId": "aab72385-5852-4da8-aeff-703ddfc4105d" },
            "callback_time": { "kind": "value", "valueId": "d6d00a32-836b-4e50-9619-f2d11d988659" }
          }
        }
      },
      "postCallWebhook": { "mode": "hold" }
    }
  },
  "errors": null
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Disposition not found"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.