Skip to main content
GET
/
v0
/
memories
List memories with filters (paginate).
curl --request GET \
  --url https://api.flumes.ai/v0/memories \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "namespace": "default",
      "type": "fact",
      "text": "<string>",
      "memory_id": "<string>",
      "org_id": "<string>",
      "agent_id": "<string>",
      "entity_id": "<string>",
      "metadata": {},
      "tags": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "archived": false,
      "sensitivity": "auto",
      "subject": "<string>",
      "predicate": "<string>",
      "object": "<string>",
      "object_type": "literal",
      "unit": "<string>",
      "keys": [
        "<string>"
      ],
      "valid_from": "2023-11-07T05:31:56Z",
      "valid_to": "2023-11-07T05:31:56Z",
      "confidence": 0.5,
      "status": "active",
      "provenance": {}
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.flumes.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Flumes-Agent
string

Agent id within the org.

Maximum string length: 128

Query Parameters

​
entity_id
string
​
namespace
string
default:default
​
type
string
​
tag
string
​
archived
boolean
default:false
​
before
string<date-time>
​
after
string<date-time>
​
sort
enum<string>
default:timestamp_desc
Available options:
timestamp_desc,
timestamp_asc
​
limit
integer
default:50

Hint; server may return fewer items.

Required range: x <= 200
​
cursor
string | null

Opaque cursor returned by previous page.

Response

Page of memories

​
items
object[]
​
next_cursor
string | null