Memory

List or semantically search memories (debug/admin)

Changed on

The operator key, a user, and the lead see every agent's memories. Any other agent (an aseph_ session token, or the shared key with X-Agent-ID) sees only its own memories and swarm-scope memories.

post/api/memory/list

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/memory/list
  • Auth
    HTTP bearer

Request body

querystring

Natural-language query. If present, runs semantic search; otherwise lists by recency.

agentIdstring

Filter to a single agent. Omit for all.

scope'agent' | 'swarm' | 'all'
source'manual' | 'file_index' | 'session_summary' | 'task_completion'
sourcePathstring

Substring match against sourcePath (case-insensitive). Useful for file_index memories.

limitinteger
offsetinteger

Response

Memory list / search results

totalnumber required
limitnumber required
offsetnumber required
mode'semantic' | 'list' required

Changes

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status