POST
Start a Staged Snapshot
Starts a staged complete snapshot. No debt is changed until finalization is queued and the worker validates the complete upload.

Authentication and limits

Requires debts:write. Uses the write limiter: 500 requests/hour per company. The request body is limited to 10 MiB.
string
required
Your campaign reference.
string
required
Your client-created, stable reference for this complete logical snapshot. Use an immutable export ID or UUID; do not use a date alone. Generate a reference. Reuse it only to retry the same content.
integer
required
Final count from 0 to 100,000.
A retry with the same count returns 200 with the existing status. A changed count returns 409 snapshot_reference_conflict. A reference already used for one-request delivery returns snapshot_delivery_mode_conflict. Only a new 201 response includes Location; status_url is present in both responses.