Xmemory icon

Xmemory

Memory operations via Xmemory API

Read

AI-generated

Summary

Queries an Xmemory instance with a natural language prompt and returns the API response as n8n items. You can choose the response mode and optionally restrict the read to specified objects and their relations.

Inputs

  • Instance ID (required) — ID of the Xmemory instance to query.
  • Query (required) — Natural language question for the memory reader.
  • Mode — Response mode: Single Answer (default), Raw Tables, or XResponse.
  • Scope Objects — Optional list of objects to restrict the read to. For each object, provide its type (PascalCase class or snake_case table) and key fields identifying its primary key. Leave empty to read across the whole instance.
  • Relations Scope — For scoped reads, choose No Relations (default) to expose only the specified objects, or All Relations to also expose relations among them.
  • Trace ID — Optional trace ID included in the request for tracing.

Output shape

A list of items from the API response, or a single item containing the response when it has no items.

Each returned item is paired with its input item. If the response provides a console_url, it is added to returned items that do not already have one. With Continue On Fail enabled, errors are returned as items with status and error fields.

Links

Discussion