Skip to main content
GET
https://api.memcontext.in
/
api
/
memories
/
{id}
Get a memory by ID
curl --request GET \
  --url https://api.memcontext.in/api/memories/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "userId": "<string>",
  "content": "<string>",
  "isCurrent": true,
  "version": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "scope": "<string>",
  "project": "<string>",
  "supersedesId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rootId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "validFrom": "2023-11-07T05:31:56Z",
  "validUntil": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-API-Key
string
header
required

API key created from the MemContext dashboard. Keys are prefixed with mc_.

Path Parameters

​
id
string<uuid>
required

Memory UUID.

Query Parameters

​
scope
string

Hard isolation boundary. When provided, the memory must belong to this scope.

Maximum string length: 200

Response

Full memory record.

​
id
string<uuid>
required
​
userId
string
required
​
content
string
required
​
source
enum<string>
required

Where the memory originated.

  • mcp - Saved via MCP tool.
  • web - Saved from the dashboard.
  • api - Saved via REST API (default).
  • openclaw - Saved via OpenClaw integration.
Available options:
mcp,
web,
api,
openclaw
​
isCurrent
boolean
required

Whether this is the current version of this memory.

​
version
integer
required

Version number in the chain (starts at 1).

​
createdAt
string<date-time>
required
​
category
enum<string>
  • preference - User likes or dislikes (e.g. "prefers dark mode").
  • fact - Objective information (e.g. "uses macOS").
  • decision - Choices made (e.g. "chose the new billing provider").
  • context - Background information (e.g. "working on e-commerce app").
Available options:
preference,
fact,
decision,
context
​
scope
string | null
​
project
string | null
​
supersedesId
string<uuid> | null

ID of the memory this version superseded.

​
rootId
string<uuid> | null

ID of the original memory in the version chain.

​
validFrom
string<date-time> | null
​
validUntil
string<date-time> | null

ISO 8601 datetime after which this memory is considered expired.