Skip to main content
PATCH
Publish a complete verified checkpoint

Authorizations

Authorization
string
header
required

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

Path Parameters

lease_id
string
required

Native lease UUIDv7.

checkpoint_id
string
required

Native checkpoint UUIDv7.

Body

application/json

Commit only after complete pages and registered objects verify.

covered_input_sequence
integer<int64>
required

Inputs included in the saved state.

Required range: x >= 0
effect_watermark
integer<int64>
required

Confirmed effects incorporated locally, never merely observed remotely.

Required range: x >= 0
fencing_token
integer<int64>
required

Existing lease fence.

Required range: x >= 0
history_digest
string
required

Complete compatible conversation digest.

manifest_root
string
required

Canonical ordered page-root digest.

pin_id
string
required

Current writer pin.

task
object
required

Current task version.

Response

Native checkpoint result

Native recovery descriptor, bounded independently of manifest size.

base_page_ids
string[]
required

Verified retained base pages, read through the same scoped page resource.

checkpoint_id
string
required

Native task-bound plan.

covered_input_sequence
integer<int64>
required

Inputs actually incorporated in this state.

Required range: x >= 0
effect_watermark
integer<int64>
required

Confirmed outcomes incorporated in this state.

Required range: x >= 0
expires_at
string<date-time>
required

Deadline established once when the plan is created.

format_version
integer<int32>
required

Required restore format.

Required range: x >= 0
generation
integer<int64>
required

Checkpoint ordering, distinct from the task generation.

Required range: x >= 0
mode
enum<string>
required

Base or incremental state.

Available options:
retain_base,
incremental
page_ids
string[]
required

Complete ordered pages; never an unbounded inline manifest.

pin
object
required

Current writer/reader pin.

replayed
boolean
required

Immutable plan replay.

repository
string
required

Repository identity selected by native task authority.

toolbox_digest
string
required

Host-local toolbox compatibility.

base_commit_oid
string | null

Exact base commit, independent of a later published branch head.

base_id
string | null

Retained base identity when present.

base_manifest_root
string | null

Ordered retained-base root, checked before overlaying local changes.

history_digest
string | null

History state bound to the same file generation.

manifest_root
string | null

Absent until native verification commits.