curl -X GET "https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-Api-Key: pk_live_your_api_key"
const response = await fetch(
'https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
{ headers: { 'X-Api-Key': 'pk_live_your_api_key' } }
);
import requests
response = requests.get(
"https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
headers={"X-Api-Key": "pk_live_your_api_key"}
)
{
"success": true,
"data": {
"topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"content": "Should the Lakers trade Anthony Davis before the deadline?",
"status": "completed",
"created_at": "2026-01-30T15:30:00Z",
"commentaries": [
{
"persona_id": "persona-abc-123",
"persona_name": "Coach Mike",
"persona_image": "https://storage.unleeshed.ai/personas/coach-mike.jpg",
"status": "completed",
"commentary": {
"id": "comm-111-...",
"content": "Look, AD is still one of the best two-way players...",
"audio_url": null,
"video_url": null
}
},
{
"persona_id": "persona-xyz-789",
"persona_name": "Sports Analyst Sarah",
"persona_image": "https://storage.unleeshed.ai/personas/sarah.jpg",
"status": "completed",
"commentary": {
"id": "comm-222-...",
"content": "From a pure analytics standpoint...",
"audio_url": null,
"video_url": null
}
}
],
"summary": {
"total_personas": 2,
"completed": 2,
"pending": 0,
"failed": 0
}
}
}
{
"success": false,
"error": {
"code": "not_found",
"message": "Topic not found"
}
}
Topics
Get Topic
Get a topic with all commentaries and status summary
GET
/
partner
/
v1
/
topics
/
{id}
curl -X GET "https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-Api-Key: pk_live_your_api_key"
const response = await fetch(
'https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
{ headers: { 'X-Api-Key': 'pk_live_your_api_key' } }
);
import requests
response = requests.get(
"https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
headers={"X-Api-Key": "pk_live_your_api_key"}
)
{
"success": true,
"data": {
"topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"content": "Should the Lakers trade Anthony Davis before the deadline?",
"status": "completed",
"created_at": "2026-01-30T15:30:00Z",
"commentaries": [
{
"persona_id": "persona-abc-123",
"persona_name": "Coach Mike",
"persona_image": "https://storage.unleeshed.ai/personas/coach-mike.jpg",
"status": "completed",
"commentary": {
"id": "comm-111-...",
"content": "Look, AD is still one of the best two-way players...",
"audio_url": null,
"video_url": null
}
},
{
"persona_id": "persona-xyz-789",
"persona_name": "Sports Analyst Sarah",
"persona_image": "https://storage.unleeshed.ai/personas/sarah.jpg",
"status": "completed",
"commentary": {
"id": "comm-222-...",
"content": "From a pure analytics standpoint...",
"audio_url": null,
"video_url": null
}
}
],
"summary": {
"total_personas": 2,
"completed": 2,
"pending": 0,
"failed": 0
}
}
}
{
"success": false,
"error": {
"code": "not_found",
"message": "Topic not found"
}
}
Path Parameters
string
required
Topic UUID returned from
POST /topicsResponse
string
Topic identifier.
string
The topic content.
string
Overall status:
pending, in_progress, partial, completedarray
Array of commentary objects for each persona.
object
Progress summary with
total_personas, completed, pending, failed.curl -X GET "https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-Api-Key: pk_live_your_api_key"
const response = await fetch(
'https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
{ headers: { 'X-Api-Key': 'pk_live_your_api_key' } }
);
import requests
response = requests.get(
"https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
headers={"X-Api-Key": "pk_live_your_api_key"}
)
{
"success": true,
"data": {
"topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"content": "Should the Lakers trade Anthony Davis before the deadline?",
"status": "completed",
"created_at": "2026-01-30T15:30:00Z",
"commentaries": [
{
"persona_id": "persona-abc-123",
"persona_name": "Coach Mike",
"persona_image": "https://storage.unleeshed.ai/personas/coach-mike.jpg",
"status": "completed",
"commentary": {
"id": "comm-111-...",
"content": "Look, AD is still one of the best two-way players...",
"audio_url": null,
"video_url": null
}
},
{
"persona_id": "persona-xyz-789",
"persona_name": "Sports Analyst Sarah",
"persona_image": "https://storage.unleeshed.ai/personas/sarah.jpg",
"status": "completed",
"commentary": {
"id": "comm-222-...",
"content": "From a pure analytics standpoint...",
"audio_url": null,
"video_url": null
}
}
],
"summary": {
"total_personas": 2,
"completed": 2,
"pending": 0,
"failed": 0
}
}
}
{
"success": false,
"error": {
"code": "not_found",
"message": "Topic not found"
}
}
⌘I