Recall & Injection

Recall is the retrieval step that happens before generation.

Anchor-scoped recall

Use POST /v1/recall when your product already knows the anchor.

curl -X POST https://maas.nunchiai.com/v1/recall \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "anchor_id": "6629df4e-6ee8-4d1d-ae8a-bb1f2a35a2ab",
    "query": "What topics are trending this week?",
    "limit": 6
  }'

{
  "items": [
    {
      "atom_id": "a2c3e4d5-8a54-43df-9f13-b6694cb29e6b",
      "content": "Indie founders are discussing rising infra bills.",
      "score": 0.873
    }
  ],
  "session_id": "0897cb2f-ecf6-45ff-a84c-3dbf560bb0c2"
}

User-scoped recall

Use POST /v1/memory/recall when your product is centered on user_external_id.

curl -X POST https://maas.nunchiai.com/v1/memory/recall \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "user_external_id": "user-42",
    "session_id": "session-2026-04-01-001",
    "query": "What topics should I follow up on?"
  }'

{
  "items": [
    {
      "atom_id": "3fdb5de0-8862-4f61-b7e1-2aaf0f4c1f09",
      "content": "User asked to continue the movie discussion next time.",
      "score": 0.891
    }
  ]
}

Hydrate bounded context

Use POST /v1/memory/hydrate when you need a compact context block for a prompt.

curl -X POST https://maas.nunchiai.com/v1/memory/hydrate \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "anchor_ids": ["6629df4e-6ee8-4d1d-ae8a-bb1f2a35a2ab"],
    "query": "Summarize the latest editorial memory.",
    "token_budget": 500
  }'

{
  "context_text": "- Indie founders are discussing rising infra bills.\n- Readers responded well to billing transparency angles.",
  "used_atom_ids": [
    "a2c3e4d5-8a54-43df-9f13-b6694cb29e6b",
    "bb3a95e9-593f-46b9-8ca1-93841e8243e0"
  ]
}

Injection rules

• Recall before every model response.
• Keep injected memory bounded.
• Send feedback only when the recalled memory changed the answer.

Errors

• 400 invalid query, key, or workspace header
• 403 access policy denied
• 404 anchor missing
• 429 read rate limited