Skip to main content
PATCH
Record a physical task decision receipt

Authorizations

Authorization
string
header
required

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

Path Parameters

lease_id
string
required

Original lease UUIDv7.

call_id
string
required

Native physical decision call UUIDv7.

Body

application/json

PATCH and late renew/report receipts share the same native recorder.

fencing_token
integer<int64>
required

The original call's fence, not permission to advance a later task.

Required range: x >= 0
receipt
object
required

Canonical physical result or explicit uncertainty.

Response

Current accounting and answer disposition

Confirms receipt accounting without claiming goal completion.

call_id
string
required

Original native call identity, even after lease deletion.

disposition
enum<string>
required

Current semantic usability; never an authority grant.

Available options:
current,
stale,
unusable
replayed
boolean
required

Identical saved receipt, with no new charge or counter movement.

reserved_nanos
string
required

Remaining provisional credit, without claiming an unknown cost is zero.

state
enum<string>
required

Current durable accounting state.

Available options:
reserved,
issued,
known,
unknown,
not_sent
charged_nanos
string | null

Exact native charge when priced or proved unsent; absent while unknown.

overage_nanos
string | null

Known cost above this call's provisional credit; related paid work stops.

usage
object | null

Normalized provider categories, including known usage awaiting pricing.