Get Specific Persona Version
curl --request GET \
--url https://api.bland.ai/v1/personas/{persona_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}/versions/{version_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}/versions/{version_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}/versions/{version_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}/versions/{version_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}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}/versions/{version_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",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "archived",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a helpful assistant",
"pathway_conditions": null,
"kb_ids": [],
"call_config": null,
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T15:13:36.368Z",
"promoted_by": null,
"created_at": "2025-09-23T15:13:36.369Z",
"updated_at": "2025-09-23T15:55:57.234Z"
},
"errors": null
}
{
"error": {
"code": "VERSION_NOT_FOUND",
"message": "Version 'v2.0' not found for persona '12345678-1234-1234-1234-123456789012'",
"details": {
"persona_id": "12345678-1234-1234-1234-123456789012",
"requested_version": "v2.0",
"available_versions": ["v1.0", "v1.1", "v1.2", "v1.3-draft"],
"current_production": "v1.2",
"current_draft": "v1.3-draft"
}
}
}
Versions
Get Specific Persona Version
Retrieve a specific persona version.
GET
/
v1
/
personas
/
{persona_id}
/
versions
/
{version_id}
Get Specific Persona Version
curl --request GET \
--url https://api.bland.ai/v1/personas/{persona_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}/versions/{version_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}/versions/{version_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}/versions/{version_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}/versions/{version_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}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}/versions/{version_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",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "archived",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a helpful assistant",
"pathway_conditions": null,
"kb_ids": [],
"call_config": null,
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T15:13:36.368Z",
"promoted_by": null,
"created_at": "2025-09-23T15:13:36.369Z",
"updated_at": "2025-09-23T15:55:57.234Z"
},
"errors": null
}
{
"error": {
"code": "VERSION_NOT_FOUND",
"message": "Version 'v2.0' not found for persona '12345678-1234-1234-1234-123456789012'",
"details": {
"persona_id": "12345678-1234-1234-1234-123456789012",
"requested_version": "v2.0",
"available_versions": ["v1.0", "v1.1", "v1.2", "v1.3-draft"],
"current_production": "v1.2",
"current_draft": "v1.3-draft"
}
}
}
Headers
Your API key for authentication.
Path Parameters
The unique identifier of the persona.
The specific version identifier to retrieve (e.g., “v1.2”, “draft”, “production”).
Response
The specific version object.
Show version object
Show version object
Unique identifier for this version.
ID of the parent persona.
Version type:
production, draft, or archived.Sequential version number.
Orchestration prompt for this version (null if none).
Personality and behavior prompt for this version.
Array of pathway routing conditions (null if none).
Array of knowledge base IDs connected to this version.
Call configuration settings (null if none).
Array of default tools enabled for this version.
Version ID this was promoted from (null if initial).
When this version was promoted to production (null if not promoted).
User who promoted this version (null if auto or not promoted).
When this version was created.
When this version was last updated.
Any errors that occurred (null if none).
{
"data": {
"id": "12345678-1234-1234-1234-123456789012",
"persona_id": "12345678-1234-1234-1234-123456789013",
"version_type": "archived",
"version_number": 1,
"orchestration_prompt": null,
"personality_prompt": "You are a helpful assistant",
"pathway_conditions": null,
"kb_ids": [],
"call_config": null,
"default_tools": [],
"promoted_from_version_id": null,
"promoted_at": "2025-09-23T15:13:36.368Z",
"promoted_by": null,
"created_at": "2025-09-23T15:13:36.369Z",
"updated_at": "2025-09-23T15:55:57.234Z"
},
"errors": null
}
{
"error": {
"code": "VERSION_NOT_FOUND",
"message": "Version 'v2.0' not found for persona '12345678-1234-1234-1234-123456789012'",
"details": {
"persona_id": "12345678-1234-1234-1234-123456789012",
"requested_version": "v2.0",
"available_versions": ["v1.0", "v1.1", "v1.2", "v1.3-draft"],
"current_production": "v1.2",
"current_draft": "v1.3-draft"
}
}
}
Docs for agents: llms.txt
Was this page helpful?
⌘I