Skip to main content
POST
Record authoring accounting and terminal state

Authorizations

Authorization
string
header
required

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

Path Parameters

lease_id
string
required

UUIDv7 of the lease.

Body

application/json

The accounting variant cannot carry private text or its digest.

deletion_generation
string
required

Decimal generation originally issued with the attempt.

fence
string
required

Decimal fence originally issued with the attempt.

outcome
enum<string>
required

Bounded terminal verdict.

Available options:
completed,
failed,
timed_out,
cancelled
report_id
string
required

Stable UUID version 7 report identity, never a content digest.

usage
object
required

Cumulative observations checked against daemon dispatch receipts.

kind
enum<string>
required
Available options:
terminal
failure_reason
null | enum<string>

Required for failed/timed_out and absent otherwise.

Available options:
insufficient_balance,
model_unavailable,
context_too_large,
provider_failed,
provider_usage_unknown,
attempt_timed_out,
policy_changed
answer
string | null

Optional bounded answer; never accepted after private fencing.

Response

Durable acknowledgement

Immutable content-free acknowledgement, replayable after private deletion.

replayed
boolean
required

Whether this report identity was already acknowledged.

sequence
string
required

Decimal request sequence, never a private answer.

settled
boolean
required

False while an authoritative provider obligation remains unresolved.

state
enum<string>
required

Recorded terminal message outcome.

Available options:
completed,
failed,
timed_out,
cancelled