ADR 0049 P3 / Tier-3 (#547/#548) — the memory detail drawer's "Context usage" panel: every context snapshot whose selected-memory set referenced THIS memory, so the user sees which tasks/prompts an agent saw it in. Workspace-scoped + capped; the service owns the JSONB-containment query (the interface never touches the DB directly).

GET

/api/memories/{id}/context-snapshots

curl --request GET \
  --url https://example.com/api/memories/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/context-snapshots

Parameters

Path Parameters

id

required

string format: uuid

Memory record ID

Responses

200

Context snapshots that referenced this memory (the ‘Context usage’ reverse lookup)

Media typeapplication/json

Array<object>

object

context_text

string | null

created_at

required

string format: date-time

id

required

string format: uuid

project_id

string | null format: uuid

prompt_hash

required

string

prompt_preview

required

string

selected_memories

required

subject_id

required

string format: uuid

subject_type

required

string

user_id

string | null format: uuid

workspace_id

required

string format: uuid

Example^generated

[
  {
    "context_text": "example",
    "created_at": "2026-04-15T12:00:00Z",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "prompt_hash": "example",
    "prompt_preview": "example",
    "selected_memories": "example",
    "subject_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "subject_type": "example",
    "user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
]

400

Structured client error

401

Authentication required

403

Permission denied

500

Structured server error