List Personas
curl --request GET \
--url https://api.bland.ai/v1/personas \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/personas', 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/personas",
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/v1/personas"
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))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/personas")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas")
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": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Personas
List Personas
Retrieve a list of all personas in your organization.
GET
/
v1
/
personas
List Personas
curl --request GET \
--url https://api.bland.ai/v1/personas \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/personas', 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/personas",
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/v1/personas"
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))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/personas")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas")
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": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Headers
string
required
Your API key for authentication.
Query Parameters
integer
default:"1"
Page number for pagination.
integer
default:"20"
Number of personas to return per page (max 100).
Response
array
Array of persona objects.
Show persona object
Show persona object
string
Unique identifier for the persona.
string
Display name of the persona.
string
Role assigned to the persona.
string
Description of the persona’s purpose.
array
Array of tags associated with the persona.
string
URL of the persona’s profile image (null if none).
string
ISO 8601 timestamp of when the persona was created.
string
ISO 8601 timestamp of when the persona was last modified.
string
ISO 8601 timestamp of when the persona was deleted (null if active).
string
ID of the user who owns this persona.
string
ID of the current production version.
string
ID of the current draft version.
array
Array of inbound phone numbers using this persona.
object
Complete production version object.
Show version object
Show version object
string
Version identifier.
string
Parent persona identifier.
string
Type of version:
production or draft.integer
Sequential version number.
string
Orchestration prompt (null if none).
string
Personality and behavior prompt.
array
Array of pathway routing conditions.
array
Array of knowledge base IDs.
object
Call configuration settings.
array
Array of default tools enabled.
string
Version ID this was promoted from (null if initial).
string
When this version was promoted to production.
string
User who promoted this version (null if auto).
string
When this version was created.
string
When this version was last updated.
object
Complete draft version object (same structure as production version).
string
Any errors that occurred (null if none).
{
"data": [
{
"id": "12345678-1234-1234-1234-123456789012",
"name": "Customer Support Agent",
"role": "Customer Support",
"description": "A capable customer support agent",
"tags": ["Customer Support"],
"image_url": null,
"created_at": "2025-09-16T23:54:44.420Z",
"updated_at": "2025-09-16T23:54:59.896Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-16T23:54:44.441Z",
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.442Z",
"updated_at": "2025-09-16T23:54:44.442Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789012",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful customer support agent",
"pathway_conditions": [
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
},
{
"name": "",
"prompt": "",
"pathway_id": "",
"start_node_id": "",
"pathway_version": ""
}
],
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-16T23:54:44.463Z",
"updated_at": "2025-09-16T23:54:59.917Z"
}
},
{
"id": "12345678-1234-1234-1234-123456789013",
"name": "Sales Representative",
"role": "Sales",
"description": "A capable sales representative",
"tags": ["Sales"],
"image_url": null,
"created_at": "2025-09-23T14:40:01.089Z",
"updated_at": "2025-09-23T14:40:01.153Z",
"deleted_at": null,
"user_id": "12345678-1234-1234-1234-123456789012",
"current_production_version_id": "12345678-1234-1234-1234-123456789012",
"current_draft_version_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"current_production_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "production",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T14:40:01.109Z",
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.110Z",
"updated_at": "2025-09-23T14:40:01.110Z"
},
"current_draft_version": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "draft",
"version_number": 2,
"orchestration_prompt": null,
"personality_prompt": "You are a friendly and helpful sales representative",
"pathway_conditions": null,
"kb_ids": [],
"call_config": {
"voice": "June",
"record": true,
"language": "en-US",
"background": "office",
"max_duration": 30,
"wait_for_greeting": false,
"interruption_threshold": 500
},
"default_tools": [],
"promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
"promoted_at": null,
"promoted_by": null,
"created_at": "2025-09-23T14:40:01.132Z",
"updated_at": "2025-09-23T14:40:01.132Z"
}
}
],
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I