# Quickstart and API

Use stable persona IDs with lang=en. English and Korean responses have separate content versions.



## 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)](https://personawiki.app/me)