Skip to main content
GET
/
v1
/
agent
/
search-memories
Structured filter over the workspace context graph (Memory nodes).
curl --request GET \
  --url https://api.reload.chat/v1/agent/search-memories \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "hits": [
      {
        "id": "<string>",
        "org_id": "<string>",
        "content": "<string>",
        "confidence": 123,
        "version": 123,
        "ttl_seconds": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "last_reinforced_at": "2023-11-07T05:31:56Z",
        "expires_at": "2023-11-07T05:31:56Z",
        "invalidated_at": "2023-11-07T05:31:56Z",
        "invalidated_by": "<string>",
        "invalidated_reason": "<string>",
        "content_hash": "<string>",
        "metadata": {}
      }
    ],
    "nextCursor": "<string>"
  },
  "meta": {
    "requestId": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "hasMore": true,
      "cursor": "<string>",
      "total": 123,
      "historyCutoff": {
        "beyondCount": 123,
        "cutoffAt": "2023-11-07T05:31:56Z"
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
kind
string

Memory.kind: decision | fact | preference.

​
status
string

Memory.status: current | proposed | superseded | contested | expired | invalidated. Default: current.

​
q
string

Substring search against Memory.content. Case-insensitive. Use recall for semantic search.

​
tags
string[]

Tag list. Matches when ALL listed tags are present in metadata.tags. Up to 20 tags.

​
from
string

ISO-8601 inclusive lower bound on createdAt.

​
to
string

ISO-8601 exclusive upper bound on createdAt.

​
scope_id
string

Optional scope to restrict results to. Caller must have CAN_READ on the scope or the call returns 403.

​
cursor
string

Opaque pagination cursor returned by a previous call.

​
limit
number
default:20

Maximum hits per page. Default 20, max 100.

Response

Success

​
success
enum<boolean>
required
Available options:
true
​
data
object
required
​
meta
object