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
Path Parameters
Which environment’s checks to change. Must be
staging or production; dev is not gated and returns 400 BAD_REQUEST.Response
The environment’s remaining check configuration, in the same shape as Get Agent Checks.
null when removing the last eval deleted the configuration.{
"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?
⌘I
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"
}
]
}