---
title: "GET /api/v1/{context_id}/state"
method: GET
path: "/api/v1/{context_id}/state"
---

# GET /api/v1/{context_id}/state

`GET /api/v1/{context_id}/state`

Get the full structured memory state grouped by category

## Path parameters

- `context_id` string, required

## Response `200`

- StateResponseJson
  - `context` CategoryStateJson, required
    - `attributes` AttributeDetailJson[], required
      - `createdAt` string, required
      - `entity` string, required
      - `id` string, required
      - `importance` number, double, required
      - `key` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `supersededBy` string, nullable
      - `supersedes` string, nullable
      - `validFrom` string, nullable
      - `validUntil` string, nullable
      - `value` string, required
    - `entities` EntityDetailJson[], required
      - `createdAt` string, required
      - `entityType` string, required
      - `id` string, required
      - `importance` number, double, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `name` string, required
      - `updatedAt` string, required
    - `relations` RelationDetailJson[], required
      - `createdAt` string, required
      - `id` string, required
      - `label` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `object` string, required
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `subject` string, required
      - `validFrom` string, nullable
      - `validUntil` string, nullable
  - `identity` CategoryStateJson, required
    - `attributes` AttributeDetailJson[], required
      - `createdAt` string, required
      - `entity` string, required
      - `id` string, required
      - `importance` number, double, required
      - `key` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `supersededBy` string, nullable
      - `supersedes` string, nullable
      - `validFrom` string, nullable
      - `validUntil` string, nullable
      - `value` string, required
    - `entities` EntityDetailJson[], required
      - `createdAt` string, required
      - `entityType` string, required
      - `id` string, required
      - `importance` number, double, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `name` string, required
      - `updatedAt` string, required
    - `relations` RelationDetailJson[], required
      - `createdAt` string, required
      - `id` string, required
      - `label` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `object` string, required
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `subject` string, required
      - `validFrom` string, nullable
      - `validUntil` string, nullable
  - `instructions` InstructionSummaryJson[], required
    - `description` string, required
    - `id` string, required
    - `label` string, required
  - `knowledge` CategoryStateJson, required
    - `attributes` AttributeDetailJson[], required
      - `createdAt` string, required
      - `entity` string, required
      - `id` string, required
      - `importance` number, double, required
      - `key` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `supersededBy` string, nullable
      - `supersedes` string, nullable
      - `validFrom` string, nullable
      - `validUntil` string, nullable
      - `value` string, required
    - `entities` EntityDetailJson[], required
      - `createdAt` string, required
      - `entityType` string, required
      - `id` string, required
      - `importance` number, double, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `name` string, required
      - `updatedAt` string, required
    - `relations` RelationDetailJson[], required
      - `createdAt` string, required
      - `id` string, required
      - `label` string, required
      - `memoryCategory` 'identity' | 'knowledge' | 'context', required — Memory category classification applied during extraction.
      - `object` string, required
      - `source` SourceRefJson — Compact provenance ref carried on attribute/relation detail JSON.
        - `kind` string, required — Source kind: `turn`, `document`, `upsert`, `reflect`, `elaboration`, or `consolidation`.
        - `ref` string, nullable — Compact navigable ref — `turn:<id>`, `doc:<id>`, or `trace:<id>` — when the source carries one. Document refs carry no passage index (only the passage record id is stored).
        - `sessionId` string, nullable — The session the source turn belongs to (`turn` kind only).
      - `subject` string, required
      - `validFrom` string, nullable
      - `validUntil` string, nullable
  - `unknowns` UncertaintySummaryJson[], required
    - `about` string, required
    - `reason` string, required

## Other responses

- `401` — Unauthorized
- `422` — Invalid context id

---

[API](https://skmtc.net/surrealdb/apis/spectron.md) · [All operations](https://skmtc.net/surrealdb/apis/spectron/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surrealdb/spectron/revisions/52b41ab517b6/schema)