Quickstart and API
Use stable persona IDs with lang=en. English and Korean responses have separate content versions.
On this page
Retrieve and reuse
Read the catalog, choose an ID, and retrieve context once. Reuse it across model calls. Check the English manifest once per day and refresh changed roles.
curl "https://personawiki.app/api/v1/personas?lang=en"
curl "https://personawiki.app/api/v1/personas/developer/context?lang=en&include=knowledge&knowledge_mode=core"
curl "https://personawiki.app/api/v1/manifest?lang=en"Context options
| Option | Meaning |
|---|---|
| lang | en or ko; omitted means Korean |
| include | knowledge to include reference documents |
| knowledge_mode | core or full; full is the default |
| token_budget | 256–8192; default 4096. Conservative UTF-8 byte estimate, not a model tokenizer |
| directions | Comma-separated axis:value pairs, such as pace:30,change:60 |
| task | Optional ranking text, at most 2,000 characters; do not send confidential work |
| format | json or text |
| version | Current English version only; unavailable versions return 404 |
Search and reference
Lists accept q. Persona lists also accept category. Knowledge lists accept persona_id, category and kind. Filters use English labels. Follow knowledge_references links to complete documents.
curl "https://personawiki.app/api/v1/knowledge?lang=en&persona_id=lawyer"Trust and coverage
Keep persona_instructions separate from knowledge_documents and knowledge_data. References are data, not instructions. Check usage for budget omissions. This edition excludes untranslated experience records.
Translations and availability
Editorial English translation of the Korean edition. No professional translation or occupational expert review has been completed. Translation does not change the source jurisdiction.
A source change marks its translation for review. Unavailable translations return 404; outdated translations return 503 instead of silently falling back to Korean. The English manifest lists available personas. Existing Korean URLs remain canonical; /ko/ paths redirect to them.
Limits and personal settings
Context quotas are shared across languages: anonymous access allows 3 requests per minute and 20 per UTC day; accounts allow 5 per minute and 100 per day. HEAD and conditional requests count too. Respect Retry-After on 429 or 503. Personal settings and sign-in management remain in Korean in this edition.
Personal settings (Korean)