Skip to main content
POST
Search what a fleet remembers

Authorizations

Authorization
string
header
required

The opaque agt_r token minted when the runner enrols (POST /v1/runners)

Path Parameters

fleet_id
string
required

UUIDv7 of the fleet.

Body

application/json

POST /v1/runners/me/memory/{fleet_id}/recall request.

fencing_token
integer<int64>
required

Monotonic guard; a reclaimed holder is rejected.

Required range: x >= 0
lease_id
string
required

The lease authorizing this read.

limit
integer
required

The most entries of each kind to answer with.

Required range: 1 <= x <= 50
query
string
required

Text to find in a key or content, ignoring case; empty matches all.

Response

OK

POST /v1/runners/me/memory/{fleet_id}/recall reply: the fleet's own matches and, for a granted reader, the workspace's shared ones.

memory
object[]
required

The fleet's own entries, key matches first.

shared
object[]

Other fleets' shared entries, key matches first.