List Agent Deployments

GET

agents

{agent_id}

deployments

curl --request GET \
  --url https://api.bland.ai/v2/agents/{agent_id}/deployments \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v2/agents/{agent_id}/deployments', 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}/deployments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/deployments"

	req, _ := http.NewRequest("GET", 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))

}

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v2/agents/{agent_id}/deployments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "e787c15f-abe6-409d-a685-1b007aad977d",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
      "version_name": "Holiday hours",
      "semver": "1.3.2",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-10T18:42:11.904Z",
      "check_run": {
        "id": "16a5fe15-9458-4237-b884-69ce44413aae",
        "agent_id": "449bbc38-188a-4533-b73a-ebf1debdf535",
        "env_type": "staging",
        "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
        "semver": "1.3.2",
        "version_name": "Holiday hours",
        "status": "PASSED",
        "judge_names": [
          "Greeting quality"
        ],
        "scenario_ids": [
          "3b1f4c2e-8a0d-4f6b-9c5e-1d2a7e9f0b34",
          "5c8e2a17-6d4b-4e93-a1f0-7b3c9d2e5f68",
          "9e4d7b03-2c6f-48a1-b5d9-0f1e3a6c8b27"
        ],
        "scenario_count": 3,
        "config_evals": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "target_level_keys": [],
            "required": true
          }
        ],
        "simulations_count": 2,
        "overall_passed": true,
        "verdicts": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "required": true,
            "target_level_keys": [],
            "match_rate": 1,
            "score": 88,
            "passed": true
          }
        ],
        "simulation_set_id": "0cb85a21-bd7d-4a73-ace4-738507fb36a0",
        "eval_run_id": "968c3972-ecca-4878-acd5-273a21853d5b",
        "error_message": null,
        "triggered_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
        "created_at": "2026-09-10T18:30:02.117Z",
        "started_at": "2026-09-10T18:30:03.540Z",
        "completed_at": "2026-09-10T18:36:48.221Z"
      },
      "is_rollback_eligible": false
    },
    {
      "id": "579eca61-40fa-433b-8066-809927758313",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "0f5adeb8-94a2-4cc3-8e6e-015178f994b7",
      "version_name": null,
      "semver": "1.3.1",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-03T15:07:39.318Z",
      "check_run": null,
      "is_rollback_eligible": true
    }
  ],
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent not found"
    }
  ]
}

Overview

Every publish, promote, and rollback appends a deployment to the target environment’s history. A promote with version_id that moves staging also appends a staging row. This endpoint returns that history for one environment, newest first, with the latest check run recorded for each deployed version. Use is_rollback_eligible to find valid targets for Roll Back Agent. Nothing is ever deployed to dev, so env=dev returns an empty array. This endpoint does not accept restricted API keys; they receive 403 INSUFFICIENT_SCOPE.

Headers

string

required

Your API key for authentication.

Path Parameters

string

required

The agent’s unique identifier.

Query Parameters

string

default:"production"

Environment to list: dev, staging, or production. Any other value falls back to production.

integer

default:"50"

Maximum number of deployments to return. Minimum 1, maximum 200. Values outside that range are clamped; a non-numeric value falls back to 50.

Response

array

Deployments for the requested environment, newest first.

Show deployment object

string

Unique identifier for the deployment.

string

The environment this deployment was made to. Matches the env query parameter.

string | null

The action that recorded the deployment: publish, promote, or rollback. null on deployments recorded before this field existed.

string

ID of the version that was deployed.

string | null

The version’s saved name, or null if it was never named.

string

The version number recorded on this deployment. A version keeps the number minted the first time it was published or promoted; later deployments of it re-record that number.

string | null

ID of the user who made the deployment. With an API key, this is the user the key belongs to. null when no user was recorded.

string

ISO 8601 timestamp of the deployment.

object | null

The newest check run that scored this deployment’s version, regardless of the environment the run targeted. null if the version has never been checked. See data[].check_run below.

boolean

true for production deployments whose version is not the current production pin. Always false for dev and staging.

object | null

The check run attached to a deployment.

Show check run object

string

Unique identifier for the check run.

string

The agent the run belongs to.

string

The environment the run was started for: staging or production.

string

The version the run scored.

string | null

The scored version’s number, or null if it had not been published when the run was read.

string | null

The scored version’s saved name, or null.

string

One of PENDING, RUNNING, PASSED, FAILED, ERROR, CANCELLED.

string[]

Display names of the judges configured when the run started.

string[]

IDs of the test scenarios in the run.

integer

Number of test scenarios in the run.

array

The evaluations configured when the run started. Each has eval_agent_id, eval_agent_version_id, name (omitted when unknown), target_level_keys, and required.

integer

Conversations generated per scenario.

boolean | null

true when every required judge passed, false when one failed, null while the run has no verdict.

array | null

One entry per judge once the run finishes, otherwise null. Each has eval_agent_id, eval_agent_version_id, name, required, target_level_keys (string array, empty for pass/fail judges), match_rate (number or null), score (0 to 100, or null), and passed (boolean or null).

string | null

ID of the simulated conversation set, once created.

string | null

ID of the evaluation run that scored the simulations, once started.

string | null

Failure detail when status is ERROR.

string | null

ID of the user who started the run, or null.

string

ISO 8601 timestamp the run was created.

string | null

ISO 8601 timestamp the run began executing, or null.

string | null

ISO 8601 timestamp the run reached a terminal status, or null.

null | array

null on success, or a list of error objects if the request failed.

{
  "data": [
    {
      "id": "e787c15f-abe6-409d-a685-1b007aad977d",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
      "version_name": "Holiday hours",
      "semver": "1.3.2",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-10T18:42:11.904Z",
      "check_run": {
        "id": "16a5fe15-9458-4237-b884-69ce44413aae",
        "agent_id": "449bbc38-188a-4533-b73a-ebf1debdf535",
        "env_type": "staging",
        "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
        "semver": "1.3.2",
        "version_name": "Holiday hours",
        "status": "PASSED",
        "judge_names": [
          "Greeting quality"
        ],
        "scenario_ids": [
          "3b1f4c2e-8a0d-4f6b-9c5e-1d2a7e9f0b34",
          "5c8e2a17-6d4b-4e93-a1f0-7b3c9d2e5f68",
          "9e4d7b03-2c6f-48a1-b5d9-0f1e3a6c8b27"
        ],
        "scenario_count": 3,
        "config_evals": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "target_level_keys": [],
            "required": true
          }
        ],
        "simulations_count": 2,
        "overall_passed": true,
        "verdicts": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "required": true,
            "target_level_keys": [],
            "match_rate": 1,
            "score": 88,
            "passed": true
          }
        ],
        "simulation_set_id": "0cb85a21-bd7d-4a73-ace4-738507fb36a0",
        "eval_run_id": "968c3972-ecca-4878-acd5-273a21853d5b",
        "error_message": null,
        "triggered_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
        "created_at": "2026-09-10T18:30:02.117Z",
        "started_at": "2026-09-10T18:30:03.540Z",
        "completed_at": "2026-09-10T18:36:48.221Z"
      },
      "is_rollback_eligible": false
    },
    {
      "id": "579eca61-40fa-433b-8066-809927758313",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "0f5adeb8-94a2-4cc3-8e6e-015178f994b7",
      "version_name": null,
      "semver": "1.3.1",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-03T15:07:39.318Z",
      "check_run": null,
      "is_rollback_eligible": true
    }
  ],
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent not found"
    }
  ]
}

Docs for agents: llms.txt

⌘I

List Agent Deployments

curl --request GET \
  --url https://api.bland.ai/v2/agents/{agent_id}/deployments \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v2/agents/{agent_id}/deployments', 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}/deployments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/deployments"

	req, _ := http.NewRequest("GET", 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))

}

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v2/agents/{agent_id}/deployments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "e787c15f-abe6-409d-a685-1b007aad977d",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
      "version_name": "Holiday hours",
      "semver": "1.3.2",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-10T18:42:11.904Z",
      "check_run": {
        "id": "16a5fe15-9458-4237-b884-69ce44413aae",
        "agent_id": "449bbc38-188a-4533-b73a-ebf1debdf535",
        "env_type": "staging",
        "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
        "semver": "1.3.2",
        "version_name": "Holiday hours",
        "status": "PASSED",
        "judge_names": [
          "Greeting quality"
        ],
        "scenario_ids": [
          "3b1f4c2e-8a0d-4f6b-9c5e-1d2a7e9f0b34",
          "5c8e2a17-6d4b-4e93-a1f0-7b3c9d2e5f68",
          "9e4d7b03-2c6f-48a1-b5d9-0f1e3a6c8b27"
        ],
        "scenario_count": 3,
        "config_evals": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "target_level_keys": [],
            "required": true
          }
        ],
        "simulations_count": 2,
        "overall_passed": true,
        "verdicts": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "required": true,
            "target_level_keys": [],
            "match_rate": 1,
            "score": 88,
            "passed": true
          }
        ],
        "simulation_set_id": "0cb85a21-bd7d-4a73-ace4-738507fb36a0",
        "eval_run_id": "968c3972-ecca-4878-acd5-273a21853d5b",
        "error_message": null,
        "triggered_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
        "created_at": "2026-09-10T18:30:02.117Z",
        "started_at": "2026-09-10T18:30:03.540Z",
        "completed_at": "2026-09-10T18:36:48.221Z"
      },
      "is_rollback_eligible": false
    },
    {
      "id": "579eca61-40fa-433b-8066-809927758313",
      "env_type": "production",
      "kind": "promote",
      "agent_version_id": "0f5adeb8-94a2-4cc3-8e6e-015178f994b7",
      "version_name": null,
      "semver": "1.3.1",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-03T15:07:39.318Z",
      "check_run": null,
      "is_rollback_eligible": true
    }
  ],
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent not found"
    }
  ]
}