Cancel Eval Run
curl --request POST \
--url https://api.bland.ai/v1/evals/runs/{run_id}/cancellations \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/runs/{run_id}/cancellations"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/runs/{run_id}/cancellations', 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/evals/runs/{run_id}/cancellations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/evals/runs/{run_id}/cancellations"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/evals/runs/{run_id}/cancellations")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/runs/{run_id}/cancellations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"status": "CANCELLED",
"triggered_by": "manual",
"run_mode": "text",
"submitted_call_ids": [
"a1b2c3d4-0000-0000-0000-000000000001",
"a1b2c3d4-0000-0000-0000-000000000002",
"a1b2c3d4-0000-0000-0000-000000000003"
],
"submitted_attached_agents": [
{
"eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
"eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
"weight": 100,
"target_level_keys": ["pass"]
}
],
"workbench_setup_id": null,
"workbench_setup_version_id": null,
"resolved_call_count": 3,
"resolved_agent_count": 1,
"resolved_atom_count": 3,
"completed_atom_count": 1,
"summary": null,
"billable_cost_usd": 0.01,
"error_code": null,
"error_message": null,
"workflow_id": null,
"metadata": {},
"created_at": "2026-05-27T10:00:00.000Z",
"started_at": "2026-05-27T10:00:05.000Z",
"completed_at": "2026-05-27T10:00:38.000Z"
},
"errors": null
}
Experiments
Cancel Eval Run
Cancel a pending, queued, or running eval run.
POST
/
v1
/
evals
/
runs
/
{run_id}
/
cancellations
Cancel Eval Run
curl --request POST \
--url https://api.bland.ai/v1/evals/runs/{run_id}/cancellations \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/runs/{run_id}/cancellations"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/runs/{run_id}/cancellations', 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/evals/runs/{run_id}/cancellations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/evals/runs/{run_id}/cancellations"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/evals/runs/{run_id}/cancellations")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/runs/{run_id}/cancellations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"status": "CANCELLED",
"triggered_by": "manual",
"run_mode": "text",
"submitted_call_ids": [
"a1b2c3d4-0000-0000-0000-000000000001",
"a1b2c3d4-0000-0000-0000-000000000002",
"a1b2c3d4-0000-0000-0000-000000000003"
],
"submitted_attached_agents": [
{
"eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
"eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
"weight": 100,
"target_level_keys": ["pass"]
}
],
"workbench_setup_id": null,
"workbench_setup_version_id": null,
"resolved_call_count": 3,
"resolved_agent_count": 1,
"resolved_atom_count": 3,
"completed_atom_count": 1,
"summary": null,
"billable_cost_usd": 0.01,
"error_code": null,
"error_message": null,
"workflow_id": null,
"metadata": {},
"created_at": "2026-05-27T10:00:00.000Z",
"started_at": "2026-05-27T10:00:05.000Z",
"completed_at": "2026-05-27T10:00:38.000Z"
},
"errors": null
}
Cancels an eval run in the
PENDING, QUEUED, or RUNNING status. Runs in a terminal status return a 409 error.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The ID of the eval run to cancel. The run must be in the
PENDING, QUEUED, or RUNNING status.Response
string
Unique identifier for the eval run.
string
The organization that owns this run.
string
Updated status of the run. Will be
CANCELLED.string
How the run was triggered. One of
manual, auto, backfill.string
The scoring modality. One of
text, audio, full.array of string
The call IDs that were submitted for scoring.
array of objects
The agent attachments submitted with the run.
string or null
The associated workbench setup, if any.
string or null
The pinned workbench setup version, if any.
integer
Number of calls resolved for the run.
integer
Number of eval agents resolved for the run.
integer
Total call-by-agent evaluations in the run.
integer
Number of evaluations completed before cancellation.
object or null
Partial scoring summary if any atoms completed before cancellation, otherwise
null.number or null
Billable cost for evaluations completed before cancellation, or
null if not yet finalized.string or null
Error code if applicable, otherwise
null.string or null
Human-readable error message if applicable, otherwise
null.string or null
Internal workflow identifier, if applicable.
object
Key-value metadata attached to the run.
string
ISO 8601 timestamp when the run was created.
string or null
ISO 8601 timestamp when the run started, or
null if it never started.string or null
ISO 8601 timestamp when the run was cancelled.
{
"data": {
"id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"status": "CANCELLED",
"triggered_by": "manual",
"run_mode": "text",
"submitted_call_ids": [
"a1b2c3d4-0000-0000-0000-000000000001",
"a1b2c3d4-0000-0000-0000-000000000002",
"a1b2c3d4-0000-0000-0000-000000000003"
],
"submitted_attached_agents": [
{
"eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
"eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
"weight": 100,
"target_level_keys": ["pass"]
}
],
"workbench_setup_id": null,
"workbench_setup_version_id": null,
"resolved_call_count": 3,
"resolved_agent_count": 1,
"resolved_atom_count": 3,
"completed_atom_count": 1,
"summary": null,
"billable_cost_usd": 0.01,
"error_code": null,
"error_message": null,
"workflow_id": null,
"metadata": {},
"created_at": "2026-05-27T10:00:00.000Z",
"started_at": "2026-05-27T10:00:05.000Z",
"completed_at": "2026-05-27T10:00:38.000Z"
},
"errors": null
}
Was this page helpful?