API Reference - Unleeshed Developer Docs

Base URL

All API requests are made to:

https://prod.api.unleeshed.ai/partner/v1

Authentication

Include your API key in the X-Api-Key header:

curl -X GET "https://prod.api.unleeshed.ai/partner/v1/personas" \
  -H "X-Api-Key: pk_live_your_api_key"

Authentication Guide

Learn more about API keys, scopes, and security.

Response Format

All responses follow a consistent format:

Success Response

{
  "success": true,
  "data": { ... }
}

Error Response

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable description"
  }
}

Endpoints

Topics

Method	Endpoint	Description
`POST`	`/topics`	Create a topic for commentary
`GET`	`/topics`	List all topics
`GET`	`/topics/{id}`	Get topic with commentaries
`GET`	`/topics/{id}/commentaries`	Get only commentaries

Personas

Method	Endpoint	Description
`GET`	`/personas`	List licensed personas
`GET`	`/personas/{id}`	Get persona details

Usage

Method	Endpoint	Description
`GET`	`/usage`	Get usage statistics

API Keys

Method	Endpoint	Description
`GET`	`/api-keys`	List API keys
`POST`	`/api-keys`	Create API key
`POST`	`/api-keys/{id}/rotate`	Rotate API key
`DELETE`	`/api-keys/{id}`	Revoke API key

Rate Limits

Tier	Limit	Burst
Standard	1,000/hour	100/minute
Premium	5,000/hour	500/minute

OpenAPI Specification

The complete OpenAPI spec is available at:

https://prod.api.unleeshed.ai/openapi.json

You can also explore the API interactively via Swagger UI.

​Base URL

​Authentication

Authentication Guide

​Response Format

​Success Response

​Error Response

​Endpoints

​Topics

​Personas

​Usage

​API Keys

​Rate Limits

​OpenAPI Specification