Skip to main content
POST
Capture what a fleet learned

Authorizations

Authorization
string
header
required

Runner token beginning with agt_r, returned once by POST /v1/runners

Path Parameters

fleet_id
string
required

Fleet identifier (version 7 universally unique identifier, or UUID).

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