Get Persona
curl --request GET \
--url https://api.bland.ai/v1/personas/{persona_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}"
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/{persona_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/v1/personas/{persona_id}",
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/{persona_id}"
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/{persona_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}")
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"
}
},
"errors": null
}
Personas
Get Persona
Retrieve a specific persona.
GET
/
v1
/
personas
/
{persona_id}
Get Persona
curl --request GET \
--url https://api.bland.ai/v1/personas/{persona_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}"
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/{persona_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/v1/personas/{persona_id}",
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/{persona_id}"
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/{persona_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}")
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"
}
},
"errors": null
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The unique identifier of the persona to retrieve.
Response
object
The persona object.
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"
}
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I