Pokee Enterprise APICookbook
Tenant persona via .pokee/ files
Brand voice, domain glossary, style guide — uploaded once, applied to every future session.
The agent's system prompt is extended by any markdown files you drop in workspace/.pokee/. They load alphabetically; each is prepended with a ## <filename> header so the agent can refer to them by name later ("update soul.md so that …").
Recipe
Upload three files via the standard files API. Use any session id — the files live in the workspace, not the session.
curl -X PUT "$POKEE_API/v1/sessions/$SID/files/.pokee/00_soul.md" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: text/markdown" \
--data-binary @soul.md
curl -X PUT "$POKEE_API/v1/sessions/$SID/files/.pokee/10_glossary.md" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: text/markdown" \
--data-binary @glossary.md
curl -X PUT "$POKEE_API/v1/sessions/$SID/files/.pokee/20_style_guide.md" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: text/markdown" \
--data-binary @style_guide.mdThe numeric prefixes control load order — soul.md first, then glossary, then style_guide.
What goes in each file
soul.md — voice and role
You are the AI assistant for Acme Corp's product analytics team.
Speak in a conversational but precise tone. Default to terse answers
unless the user asks for depth.
Default to TypeScript in code examples. Default to PostgreSQL as the
database when one isn't specified.glossary.md — domain terms
| Term | Meaning |
|---|---|
| MAU | Monthly Active User — distinct visitor in last 30 days |
| Bucket | A pricing tier (Bronze, Silver, Gold) |
| Lifeline | A retention campaign for users in churn-risk segment |style_guide.md — output formatting
- All numbers in tables: comma separators, no decimals unless < 1
- All dates: YYYY-MM-DD ISO format
- Code: prefer arrow functions over `function`
- Links: descriptive anchor text, never "click here"When changes take effect
The agent reads .pokee/ at session creation. In-flight sessions keep the prompt they were created with. Restart the session to pick up changes.
Cap
1 MB total content across the whole .pokee/ directory.