List memories | Thenvoi

import requests
url = "https://platform.dev.thenvoi.com/api/v1/agent/memories"
querystring = {"subject_id":"daca00d0-eb6b-4db1-8201-c46015c93d04","scope":"subject","system":"long_term","type":"semantic","segment":"user","content_query":"prefers SUV","page_size":"20","status":"active"}
headers = {"X-API-Key": "<apiKey>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "content": "string",
      "id": "string",
      "inserted_at": "2024-01-15T09:30:00Z",
      "scope": "subject",
      "segment": "user",
      "system": "sensory",
      "type": "iconic",
      "metadata": {},
      "organization_id": "string",
      "source_agent_id": "string",
      "status": "active",
      "subject_id": "string",
      "thought": "string"
    }
  ],
  "meta": {
    "page_size": 1,
    "total_count": 1
  }
}

Lists memories accessible to the agent. By default returns:

Memories about the specified subject (cross-agent sharing)
Organization-wide shared memories

Use scope parameter to filter by visibility. Use content_query for full-text search across memory content.

Lists memories accessible to the agent. By default returns: - Memories about the specified subject (cross-agent sharing) - Organization-wide shared memories Use `scope` parameter to filter by visibility. Use `content_query` for full-text search across memory content.

Authentication

X-API-Keystring

Enter your API key for programmatic access

Query parameters

subject_idstringOptional

Filter by subject UUID (required for subject-scoped queries)

scopestringOptional

Filter by scope: subject, organization, or all

systemstringOptional

Filter by memory system

typestringOptional

Filter by memory type

segmentstringOptional

Filter by segment

content_querystringOptional

Full-text search query

page_sizeintegerOptional

Number of results per page (max 50)

statusstringOptional

Filter by status: active, superseded, archived, or all

Response

Memories

datalist of objects or null

metaobject or null

Authentication

Query parameters

Response

Errors