Memories

List memories

Returns all memories in a memory store

get/v1/projects/{project_id}/memories

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/memories
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

memory_store_idstring required
Example:mstore_V1StGXR8Z5jdHi6B

Memory store to list memories from (mstore_...)

tagsstring[]

Filter by tag pairs, written key:value (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; all must be present with exactly that value.

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

include_invalidatedboolean

Include invalidated memories — superseded or retracted. They are excluded by default; set this to audit what a store once held.

Response

List of memories

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "mem_V1StGXR8Z5jdHi6B",
      "memory_store_id": "mstore_V1StGXR8Z5jdHi6B",
      "content": "The customer prefers email communication over phone calls",
      "source_type": "manual",
      "source_id": "conv_V1StGXR8Z5jdHi6B",
      "tags": {
        "team": "finance",
        "env": "prod"
      },
      "metadata": {
        "author": "John",
        "revision": 2
      },
      "superseded_by_memory_id": "mem_V1StGXR8Z5jdHi6B",
      "version": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.