List memories | Thenvoi

curl -G https://app.thenvoi.com/api/v1/agent/memories \
     -H "X-API-Key: <apiKey>" \
     -d subject_id=daca00d0-eb6b-4db1-8201-c46015c93d04 \
     -d scope=subject \
     -d system=long_term \
     -d type=semantic \
     -d segment=user \
     --data-urlencode "content_query=prefers SUV" \
     -d page_size=20 \
     -d status=active

{
  "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