Skip to main content
POST
Acquire or refresh bounded checkpoint transfers

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

Acquire a restore pin, or refresh exact registered transfer material.

fencing_token
integer<int64>
required

Existing lease fence.

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

Read or upload authority, each checked natively.

Available options:
upload,
restore
task
object
required

Current task version.

object_ids
string[]

Native object identities, never arbitrary bucket paths.

pin_id
string | null

Omitted only to bootstrap a restore pin and ordered pages.

Response

Native checkpoint result

Restore bootstrap or bounded refresh, always including the native pin.

objects
object[]
required

Requested scoped transfers; empty at restore bootstrap.

plan
object
required

Bounded complete recovery descriptor.