Memory Kick Start

​

Step 1 — Create an API key

1. Sign in to the dashboard and open API Keys.
2. Create a key with at least the Contributor role. Use a Manager key only if you plan to run delete or export operations.
3. Copy the value and store it in your secrets manager. All Memory endpoints require the bearer token.

​

Step 2 — (Optional) Organize memories by project

​

Step 3 — Store a memory

curl https://app.recallio.ai/api/Memory/write \
  -H "Authorization: Bearer $RECALLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "resident-991",
    "projectId": "project_abc",
    "content": "Taylor Brooks prefers maintenance updates after 6pm via email.",
    "tags": ["preferences", "communications"],
    "metadata": {"capturedBy": "rpa-bot", "source": "post-visit-form"},
    "consentFlag": true
  }'

​

Step 4 — Recall the memory

curl "https://app.recallio.ai/api/Memory/recall?limit=5&similarityThreshold=0.3" \
  -H "Authorization: Bearer $RECALLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "resident-991",
    "projectId": "project_abc",
    "scope": "user",
    "query": "communication preferences",
    "tags": ["preferences"]
  }'

​

Step 5 — Summarize or explore topics (optional)

• Use /api/Memory/recall-summary to generate a digest of all facts for the user or project.
• Call /api/Memory/recall-topics to see the taxonomy Recallio extracted from the stored memories.

curl https://app.recallio.ai/api/Memory/recall-summary \
  -H "Authorization: Bearer $RECALLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "resident-991",
    "projectId": "project_abc",
    "scope": "user"
  }'

​

Step 6 — Manage data lifecycle (optional)

• Delete memories when a resident offboards:
  curl -X DELETE https://app.recallio.ai/api/Memory/delete \
    -H "Authorization: Bearer $MANAGER_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "scope": "user",
      "userId": "resident-991",
      "projectId": "project_abc"
    }'
  
• Export memories for audits:
  curl "https://app.recallio.ai/api/Memory/export?Type=fact&Format=json&ProjectId=project_abc" \
    -H "Authorization: Bearer $MANAGER_API_KEY"
  

​

Next steps

• Browse the Memory Overview for a feature map.
• Dive into the Memory Deep Dive to tune scoring, tagging, and lifecycle policies.
• Consult the Recallio Swagger reference for every field and response model.