> ## 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.

# Update Outcome

> Rename an outcome, replace its script or change its metadata.

Send only the fields you want to change. Updating `script` saves a new version and increases `snippet_version` by 1. Runs after that use the new version.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The outcome ID.

### Body Parameters

**name** `string`

A new name. 1 to 100 characters, letters and underscores only.

**script** `string`

The new JavaScript source, up to 200,000 characters. It follows the same rules as [Create Outcome](https://docs.bland.ai/api-v1/post/dispositions.md).

**metadata** `object`

Replaces the stored metadata.

### Response

**data** `object`

The updated outcome, with the same fields as [Create Outcome](https://docs.bland.ai/api-v1/post/dispositions.md) returns.

**errors** `null | array`

`null` on success, otherwise an array of error objects.

```json Response theme={null}
{
  "data": {
    "id": "59627e31-6ec8-4d03-9bfc-11c2e6c8910c",
    "org_id": "5c96ed8c-6bba-4c56-93f6-08a04e08ca47",
    "name": "appointment_outcome",
    "metadata": {},
    "snippet_id": "85352170-a09d-4557-9112-643bb8425577",
    "snippet_version": 4,
    "created_at": "2026-10-20T18:22:05.117Z",
    "updated_at": "2026-10-26T15:12:48.250Z"
  },
  "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.