vault

Mint a retention cutoff ticket

Issues the service-signed retention_cutoff a checkpoint-bearing head receipts. cutoff_at is SERVER-authoritative — root-expiry arithmetic is evaluated against a clock the client does not propose. The ticket is stored create-only and registered before it is returned, so the receipt below is a receipt for bytes that already exist; receipt it from the head's checkpoint.cutoff block and admit before it expires.

post/vaults/v1/{vault_id}/retention-cutoffs

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/vaults/v1/{vault_id}/retention-cutoffs
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer
    • HTTP bearer

Path parameters

vault_idstring required

The vault id (src_<32 hex>); the wire field is repo_id (protocol D185).

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

base_head_sha256string required

The head the cutoff is taken against, 64 lowercase hex.

Response

Ticket issued and stored

ticketobject

The complete signed retention_cutoff object.

next_actionsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.