Contexts

Standing instructions, knowledge, and custom commands attached to your mail

Endpoints

Method	Path	Description
GET	/contexts	List your context docs
POST	/contexts	Create a context doc
POST	/contexts/upload	Create from an uploaded Markdown file (max 256 KB)
GET	/contexts/{id}	Fetch one context doc
PATCH	/contexts/{id}	Update title, body, kind, slug, or enabled
DELETE	/contexts/{id}	Delete a context doc

Create

POST https://api-test.airbox.fyi/contexts
Content-Type: application/json
X-API-Key: YOUR_KEY

{
  "title": "Writing style",
  "body": "Reply tersely, no greetings, prefer bullet points.",
  "kind": "instruction",
  "enabled": true
}

A context doc is trusted standing authority folded into the system prompt for matching mail. Attach one to a message inline with the +slug email syntax.

Fields

title — display name (1–200 chars)
body — the instruction or knowledge text (Markdown)
kind — one of instruction, knowledge, or command (custom $macro — a Pro feature)
slug — stable lowercase-kebab handle for +slug syntax; auto-derived from the title when omitted
enabled — whether it is applied (default true)

Plan limits cap the number of saved contexts (Free 3 · Pro 50 · Team 200).

Upload Markdown

curl -s https://api-test.airbox.fyi/contexts/upload \
  -H "X-API-Key: YOUR_KEY" \
  -F "file=@style-guide.md" | jq

The title is taken from the first # heading (falling back to the filename); the whole file becomes the body as an instruction context.