Airclippy Logo
← Back to vault

AI Context API

Free private vault for AI chat context. Create an API key in the dashboard, save a thread, then hand a share token to any third-party agent.

Private by default

Never appears in Global clipboard feed.

API keys

Full CRUD for your contexts.

Share tokens

Scoped read / append / write with expiry.

Auth

All agent endpoints use a Bearer token:

Authorization: Bearer actx_sk_…   # API key
Authorization: Bearer actx_sh_…   # share token

Create context

curl -X POST https://airclippy.com/api/v1/contexts \
  -H "Authorization: Bearer actx_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Handoff to Agent B",
    "messages": [
      { "role": "system", "content": "You are helping with airclippy." },
      { "role": "user", "content": "Continue from here…" }
    ],
    "metadata": { "source": "cursor", "tags": ["mvp"] },
    "ttlDays": 7
  }'

List / get / update / delete

GET    /api/v1/contexts
GET    /api/v1/contexts/:id
PATCH  /api/v1/contexts/:id   # body: { title?, messages?, metadata?, append?: true }
DELETE /api/v1/contexts/:id

Mint a share token

curl -X POST https://airclippy.com/api/v1/contexts/CONTEXT_ID/share \
  -H "Authorization: Bearer actx_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scopes": ["read","append"], "ttlHours": 24, "label": "Agent B" }'

Response includes share.token once.

Agent pulls context (no API key needed)

curl https://airclippy.com/api/v1/share/actx_sh_YOUR_TOKEN

# Append messages from Agent B
curl -X PATCH https://airclippy.com/api/v1/share/actx_sh_YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "append": true,
    "messages": [
      { "role": "assistant", "content": "Done. Next steps…" }
    ]
  }'

Example: inject into your agent

const res = await fetch("https://airclippy.com/api/v1/share/" + process.env.AIRCLIPPY_SHARE);
const { context } = await res.json();

const completion = await openai.chat.completions.create({
  model: "gpt-4o-mini",
  messages: context.messages,
});

Free limits

  • 50 private contexts per account
  • 10 API keys
  • Default 7-day context TTL (max 30)
  • 512 KB payload · 500 messages max
  • 20 share grants per context