Skip to main content
POST
Reserve an upload

Headers

X-API-Key
string
required

Compute API key (create one in the dashboard under Settings → API Keys, or via agentvault login).

Example:

"x402c_..."

Body

application/json
agentId
string<uuid>
required
sizeBytes
integer
required

Payload size BEFORE encryption; the encrypted blob may exceed it slightly (envelope slack is allowed).

Response

200 - application/json

Reservation

backupId
string
r2Key
string

backups/{wallet}/{agentId}/{backupId}/blob.enc — parse it for the encryption AAD

uploadUrl
string
expiresInSeconds
integer