---
title: "Memory Graph"
method: GET
path: "/v1/scopes/{scope_name}/memory-graph"
tags: ["memory-graph"]
---

# Memory Graph

`GET /v1/scopes/{scope_name}/memory-graph`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/scopes/{scope_name}/memory-graph`
- Auth: HTTP bearer

## Path parameters

- `scope_name` string, required

## Query parameters

- `layers` string
- `limit` integer
- `cursor` string, nullable
- `query` string, nullable

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Response `200`

Successful Response

- MemoryGraphResponse
  - `counts` MemoryGraphCountsView, required
    - `edges` integer, required
    - `fast` integer, required
    - `nodes` integer, required
    - `slow` integer, required
    - `source` integer, required
  - `depth` integer, nullable
  - `edges` MemoryGraphEdgeView[], required
    - `id` string, required
    - `origin` 'stored' | 'derived', required
    - `provenance` object
    - `source` string, required
    - `target` string, required
    - `type` string, required
    - `weight` number, required
  - `fallback_layer` 'slow' | 'fast' | 'source', nullable
  - `missing_memory_ids` string[]
  - `nodes` MemoryGraphNodeView[], required
    - `actor_role` 'user' | 'assistant' | 'system' | 'tool', nullable
    - `actor_roles` string[]
    - `attributes` object
    - `authority` string, nullable
    - `category` string, required
    - `cluster_id` string, nullable
    - `confidence` number, required
    - `evidence_count` integer, required
    - `expandable` boolean, required
    - `id` string, required
    - `kind` string, required
    - `label` string, required
    - `layer` 'slow' | 'fast' | 'source', required
    - `occurred_at` string, nullable
    - `provenance_source` string, nullable
    - `relation` string, required
    - `salience` number, required
    - `source_kind` string, nullable
    - `state` string, required
    - `status` string, required
    - `subject_id` string, nullable
    - `summary` string, required
    - `turn_index` integer, required
    - `visible_neighbor_count` integer, required
  - `page` MemoryGraphPageView, required
    - `limit` integer, required
    - `next_cursor` string, nullable
    - `offset` integer, required
    - `returned_neighbors` integer, nullable
    - `truncated` boolean, required
  - `provisional` boolean
  - `requested_layers` string[], required
  - `resolved_layers` string[], required
  - `root_id` string, nullable
  - `schema_version` string, required
  - `scope_name` string, required
  - `selected_memory_ids` string[]
  - `snapshot_id` string, required
  - `snapshot_state` 'committed' | 'building'
  - `view` 'overview' | 'neighbors' | 'recall_trace', required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tmcra/apis/tmcra-memory-api.md) · [All operations](https://skmtc.dev/tmcra/apis/tmcra-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tmcra/apis/tmcra-memory-api/revisions/597be9dc7a3d?raw)