Skip to main content
POST
https://memorymachines-core-api-mvp-gateway-6v1lw71z.uc.gateway.dev
/
v1
/
memories
/
recall
curl -X POST https://memorymachines-core-api-mvp-gateway-6v1lw71z.uc.gateway.dev/v1/memories/recall \
  -H "x-api-key: YOUR_API_KEY" \
  -F "text=team meetings"
{
  "memories": [
    {
      "custom_id": "meeting-jan15_memory_0",
      "item_id": "meeting-jan15",
      "score": 0.94,
      "content": {
        "narrative": "I attended the weekly team sync with Sarah, Mike, and Jennifer. We reviewed sprint progress and discussed the upcoming product launch timeline.",
        "participants": ["Sarah", "Mike", "Jennifer"],
        "when": "January 15, 2025, 10:00 AM",
        "where": "Conference Room B",
        "entities": [
          {"name": "Q1 Roadmap", "type": "Project"}
        ],
        "tags": ["meeting", "team-sync", "sprint"]
      }
    },
    {
      "custom_id": "meeting-jan08_memory_1",
      "item_id": "meeting-jan08",
      "score": 0.87,
      "content": {
        "narrative": "I led the Q1 planning session with the engineering team. We prioritized three main objectives for the quarter.",
        "participants": ["Alex", "Mike", "Sarah"],
        "when": "January 8, 2025",
        "where": "Virtual",
        "tags": ["planning", "Q1", "engineering"]
      }
    }
  ],
  "qa": [],
  "chunks": []
}
Search your memories and get raw results without AI response generation. Useful for browsing memories or building custom experiences.
text
string
required
Search query. Max 1,000 characters.
curl -X POST https://memorymachines-core-api-mvp-gateway-6v1lw71z.uc.gateway.dev/v1/memories/recall \
  -H "x-api-key: YOUR_API_KEY" \
  -F "text=team meetings"
{
  "memories": [
    {
      "custom_id": "meeting-jan15_memory_0",
      "item_id": "meeting-jan15",
      "score": 0.94,
      "content": {
        "narrative": "I attended the weekly team sync with Sarah, Mike, and Jennifer. We reviewed sprint progress and discussed the upcoming product launch timeline.",
        "participants": ["Sarah", "Mike", "Jennifer"],
        "when": "January 15, 2025, 10:00 AM",
        "where": "Conference Room B",
        "entities": [
          {"name": "Q1 Roadmap", "type": "Project"}
        ],
        "tags": ["meeting", "team-sync", "sprint"]
      }
    },
    {
      "custom_id": "meeting-jan08_memory_1",
      "item_id": "meeting-jan08",
      "score": 0.87,
      "content": {
        "narrative": "I led the Q1 planning session with the engineering team. We prioritized three main objectives for the quarter.",
        "participants": ["Alex", "Mike", "Sarah"],
        "when": "January 8, 2025",
        "where": "Virtual",
        "tags": ["planning", "Q1", "engineering"]
      }
    }
  ],
  "qa": [],
  "chunks": []
}

Response Fields

Memory Object

FieldTypeDescription
custom_idstringUnique memory identifier
item_idstringSource document ID
scorefloatRelevance score (0-1)
contentobjectMemory content

Content Object

FieldTypeDescription
narrativestringFirst-person description
participantsarrayPeople involved
whenstringTime/date
wherestringLocation
entitiesarrayNamed entities
tagsarrayKeywords

Use Cases

Memory Browser

Display memories in a list view for users to browse

Debugging

See exactly which memories are being retrieved

Custom UI

Build custom visualizations with raw memory data

Filtering

Post-process results by date, participants, etc.