REST API Reference

Base URL: https://openpersona.io/api/v1

Public endpoints require no authentication. Authenticated endpoints use Bearer tokens:Authorization: Bearer op_live_xxxx

Endpoints

GET/api/v1/personasList personas (paginated, searchable)

GET/api/v1/personas/{slug}Get persona detail

GET/api/v1/personas/{slug}/download?format=md|jsonDownload persona file

GET/api/v1/teamsList teams (paginated, searchable)

GET/api/v1/teams/{slug}Get team detail with members

GET/api/v1/teams/{slug}/downloadDownload team ZIP

GET/api/v1/qualitiesList qualities (filterable by category)

GET/api/v1/categoriesList quality categories

GET/api/v1/search?q=keywordSearch across all content

GET/api/v1/leaderboardPopularity leaderboard

GET/api/v1/user/starsList user's starsAuth

POST/api/v1/user/starsToggle star on contentAuth

GET/api/v1/user/bookmarksList user's bookmarksAuth

POST/api/v1/user/bookmarksToggle bookmark on contentAuth

GET/api/v1/user/api-keysList API keysAuth

POST/api/v1/user/api-keysGenerate new API keyAuth

DELETE/api/v1/user/api-keysRevoke an API keyAuth

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 142,
    "totalPages": 8
  }
}

Tier	Req/Min	Req/Hour	Req/Day
Anonymous	30	500	5,000
Free	100	3,000	50,000
Pro	500	15,000	200,000
Team	1,000	30,000	500,000
Enterprise	Custom	Custom	Custom