Get a memory by ID - MemContext

Get a memory by ID

curl --request GET \
  --url https://api.memcontext.in/api/memories/{id} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.memcontext.in/api/memories/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.memcontext.in/api/memories/{id}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>",
  "errorId": "<string>"
}

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>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.memcontext.in/api/memories/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.memcontext.in/api/memories/{id}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>",
  "errorId": "<string>"
}

Authorizations

X-API-Key

string

header

required

API key created from the MemContext dashboard. Keys are prefixed with mc_, bound to one workspace, and API-key requests cannot override that workspace.

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.

Search memories Delete a memory