Skip to main content
POST
Capture what a fleet learned

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} 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 write.

memory
object[]
required

The items to remember.

Response

OK

POST /v1/runners/me/memory/{fleet_id} reply — what the write did.

skipped
integer
required

Deltas refused for shape, which the runner should investigate.

Required range: x >= 0
stored
integer
required

Deltas written, after upsert.

Required range: x >= 0