Outcomes
Update Outcome
Rename an outcome, replace its script or change its metadata.
PATCH
/
v1
/
dispositions
/
{id}
Update Outcome
curl --request PATCH \
--url https://api.bland.ai/v1/dispositions/{id} \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"name": "<string>",
"script": "<string>",
"metadata": {}
}
'import requests
url = "https://api.bland.ai/v1/dispositions/{id}"
payload = {
"name": "<string>",
"script": "<string>",
"metadata": {}
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', script: '<string>', metadata: {}})
};
fetch('https://api.bland.ai/v1/dispositions/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/dispositions/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'script' => '<string>',
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/dispositions/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.bland.ai/v1/dispositions/{id}")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/dispositions/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition not found"
}
]
}
Send only the fields you want to change. Updating
Docs for agents: llms.txt
script saves a new version and increases snippet_version by 1. Runs after that use the new version.
Headers
Path Parameters
Body Parameters
The new JavaScript source, up to 200,000 characters. It follows the same rules as Create Outcome.
Response
The updated outcome, with the same fields as Create Outcome returns.
{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Update Outcome
curl --request PATCH \
--url https://api.bland.ai/v1/dispositions/{id} \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"name": "<string>",
"script": "<string>",
"metadata": {}
}
'import requests
url = "https://api.bland.ai/v1/dispositions/{id}"
payload = {
"name": "<string>",
"script": "<string>",
"metadata": {}
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', script: '<string>', metadata: {}})
};
fetch('https://api.bland.ai/v1/dispositions/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/dispositions/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'script' => '<string>',
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/dispositions/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.bland.ai/v1/dispositions/{id}")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/dispositions/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"script\": \"<string>\",\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition not found"
}
]
}