POST /v1/recall

Semantic search over stored memory for a scope.

Use recall when you need to find a specific past fact rather than a general context injection. context is better for LLM calls — recall is better for lookups and UI display.

Request

POST https://api.memcone.com/v1/recall
Authorization: Bearer mem_live_...
Content-Type: application/json

POST https://api.memcone.com/v1/recall
Authorization: Bearer mem_live_...
Content-Type: application/json

{
  "scopeId": "user_123",
  "query": "what programming language does this user prefer?"
}

{
  "scopeId": "user_123",
  "query": "what programming language does this user prefer?"
}

Parameters

| Field | Type | Required | Description | |---|---|---|---| | scopeId | string | ✓ | Scope to search within | | query | string | ✓ | Natural language search query |

Response

{
  "result": "user prefers TypeScript over JavaScript and always uses strict mode"
}

{
  "result": "user prefers TypeScript over JavaScript and always uses strict mode"
}

| Field | Type | Description | |---|---|---| | result | string | The most relevant stored facts as a single string. Empty if no match. |