Remove Check Eval
curl --request DELETE \
--url https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}"
headers = {"authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_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/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
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/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}"
req, _ := http.NewRequest("DELETE", 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.delete("https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"removed": true,
"config": {
"env_type": "production",
"simulations_count": 5,
"evals": [
{
"eval_agent_id": "3fec6d8e-053b-4d6b-9544-4bf559a13a1a",
"eval_agent_version_id": "f3a84fb2-81d9-41e7-95e3-3d1f7e44fb31",
"passing_level": "pass"
}
]
}
},
"errors": null
}
{
"data": {
"removed": false,
"config": null
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "env must be 'staging' or 'production'"
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Checks
Remove Check Eval
Drop one eval from an environment’s promotion checks.
DELETE
/
v2
/
agents
/
{agent_id}
/
environments
/
{env}
/
checks
/
evals
/
{eval_agent_id}
Remove Check Eval
curl --request DELETE \
--url https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}"
headers = {"authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_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/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
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/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}"
req, _ := http.NewRequest("DELETE", 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.delete("https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": {
"removed": true,
"config": {
"env_type": "production",
"simulations_count": 5,
"evals": [
{
"eval_agent_id": "3fec6d8e-053b-4d6b-9544-4bf559a13a1a",
"eval_agent_version_id": "f3a84fb2-81d9-41e7-95e3-3d1f7e44fb31",
"passing_level": "pass"
}
]
}
},
"errors": null
}
{
"data": {
"removed": false,
"config": null
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "env must be 'staging' or 'production'"
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Overview
Removes a single eval from the checks that gate promotion into an environment, leaving the rest of the roster in place. Use Set Agent Checks to replace the whole roster instead, or Delete Agent Checks to clear it. Removing the last eval deletes the environment’s check configuration entirely. The response then carriesconfig of null, and promotion into that environment is no longer gated.
The call is idempotent. Removing an eval that is not on the roster, or one from an environment with no configuration, returns 200 with removed set to false and changes nothing.
Requires an admin, owner, operator, or prompter role.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The agent’s unique identifier.
string
required
Which environment’s checks to change. Must be
staging or production; dev is not gated and returns 400 BAD_REQUEST.string
required
The eval to remove.
Response
boolean
true when an eval was taken off the roster, false when there was nothing to remove.object | null
The environment’s remaining check configuration, in the same shape as Get Agent Checks.
null when removing the last eval deleted the configuration.null | array
null on success, or a list of error objects if the request failed.{
"data": {
"removed": true,
"config": {
"env_type": "production",
"simulations_count": 5,
"evals": [
{
"eval_agent_id": "3fec6d8e-053b-4d6b-9544-4bf559a13a1a",
"eval_agent_version_id": "f3a84fb2-81d9-41e7-95e3-3d1f7e44fb31",
"passing_level": "pass"
}
]
}
},
"errors": null
}
{
"data": {
"removed": false,
"config": null
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "env must be 'staging' or 'production'"
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?