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
string
required
Your API key for authentication.
Path Parameters
string
required
The outcome ID.
Body Parameters
string
A new name. 1 to 100 characters, letters and underscores only.
string
The new JavaScript source, up to 200,000 characters. It follows the same rules as Create Outcome.
object
Replaces the stored metadata.
Response
object
The updated outcome, with the same fields as Create Outcome returns.
null | array
null on success, otherwise an array of error objects.{
"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"
}
]
}