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
string
required
Your API key for authentication.
Path Parameters
string
required
The unique identifier of the persona.
string
required
The specific version identifier to retrieve (e.g., “v1.2”, “draft”, “production”).
Response
object
The specific version object.
Show version object
Show version object
string
Unique identifier for this version.
string
ID of the parent persona.
string
Version type:
production, draft, or archived.integer
Sequential version number.
string
Orchestration prompt for this version (null if none).
string
Personality and behavior prompt for this version.
array
Array of pathway routing conditions (null if none).
array
Array of knowledge base IDs connected to this version.
object
Call configuration settings (null if none).
array
Array of default tools enabled for this version.
string
Version ID this was promoted from (null if initial).
string
When this version was promoted to production (null if not promoted).
string
User who promoted this version (null if auto or not promoted).
string
When this version was created.
string
When this version was last updated.
string
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