vault

Finalize an upload session

Verifies STORAGE's authoritative checksum and length for every declared object (a COMPOSITE / multipart checksum is refused — uploads are single-part FULL_OBJECT only), writes the permanent lifecycle rows, charges the vault's accounted bytes, and returns the per-kind receipts a head carries. Client-asserted values are never billing inputs. Idempotent: replaying a finalized session returns the same receipts with deduplicated: true.

post/vaults/v1/{vault_id}/upload-sessions/{upload_session_id}/finalize

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/vaults/v1/{vault_id}/upload-sessions/{upload_session_id}/finalize
  • 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).

upload_session_idstring required

The session's id.

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.

Response

Idempotent replay of an already-finalized session

object required

Changes

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