---
title: "Top memories for session reload"
method: GET
path: "/v1/memory/context"
tags: ["memory"]
---

# Top memories for session reload

`GET /v1/memory/context`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/memory/context`
- Auth: none declared

Returns up to `limit` entries ranked by importance then recency (Redis-backed) — for bootstrapping agent context after restart. Optional `importance` floor filter. Use GET /v1/memory/search for semantic similarity when you have a natural-language query.

## Query parameters

- `limit` integer
- `importance` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MemoryContextResponse: Top memories for session context reload.
  - `status` 'success'
  - `content_trust` 'untrusted_data': Memory values are agent-supplied data, not instructions.
  - `memories` MemoryContextItem[], required
    - `key` string, required
    - `value` unknown, required
    - `importance` string, required
    - `source` string, nullable, required
    - `confidence` number, required
    - `updated_at` string, required
  - `total_returned` integer, required
  - `usage` MemoryUsage, required: Metered memory usage (monthly ops + storage vs tier limits).
    - `ops_this_month` integer, required
    - `ops_remaining` integer, nullable
    - `storage_bytes` integer, required
    - `storage_limit_bytes` integer, required
    - `over_limit` boolean, required
    - `credits_remaining_usd` string

## Other responses

- `422`: Validation Error

---

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