Skip to main content
POST
https://api.unleeshed.ai
/
partner
/
v1
/
topics
curl -X POST "https://api.unleeshed.ai/partner/v1/topics" \
  -H "X-Api-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Should the Lakers trade Anthony Davis before the deadline?",
    "persona_ids": ["persona-abc-123", "persona-xyz-789"],
    "output_types": ["text"]
  }'
{
  "success": true,
  "data": {
    "topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "content": "Should the Lakers trade Anthony Davis before the deadline?",
    "personas_sent": 2,
    "results": [
      { "persona_id": "persona-abc-123", "status": "sent" },
      { "persona_id": "persona-xyz-789", "status": "sent" }
    ],
    "status": "pending",
    "created_at": "2026-01-30T15:30:00Z"
  }
}

Request

content
string
required
The topic content (question, statement, or prompt). 10-500 characters.
persona_ids
string[]
required
Array of persona UUIDs to send this topic to. Must have active licenses.
output_types
string[]
default:"['text']"
Desired output formats: text, audio, video
metadata
object
Custom metadata to attach (returned in responses).

Response

topic_id
string
Unique identifier for the topic. Use this to fetch commentaries.
content
string
The topic content.
personas_sent
integer
Number of personas that will generate commentary.
results
array
Per-persona status:
  • sent - Successfully queued
  • not_licensed - No active license
  • duplicate - Already sent within 24 hours
status
string
Always pending on creation.
curl -X POST "https://api.unleeshed.ai/partner/v1/topics" \
  -H "X-Api-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Should the Lakers trade Anthony Davis before the deadline?",
    "persona_ids": ["persona-abc-123", "persona-xyz-789"],
    "output_types": ["text"]
  }'
{
  "success": true,
  "data": {
    "topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "content": "Should the Lakers trade Anthony Davis before the deadline?",
    "personas_sent": 2,
    "results": [
      { "persona_id": "persona-abc-123", "status": "sent" },
      { "persona_id": "persona-xyz-789", "status": "sent" }
    ],
    "status": "pending",
    "created_at": "2026-01-30T15:30:00Z"
  }
}