Skip to main content
POST
Undo an applied setup file, or preview the undo

Authorizations

x-api-key
string
header
required

Raw API key shown once when created in the Allocait app (Settings > API keys). Send it verbatim in this header; the server stores and compares only its SHA-256 hash. Allocait generates every key: alc_ followed by 64 lowercase hex characters. Keys issued before 2026-10-10 are 64 hex characters with no prefix and keep working. A key may carry an expiry (90 days or 1 year, or never). A malformed, unknown, revoked or expired key gets 401 with no further detail, and a malformed one is refused before any lookup. Keys cannot be created through this API.

Path Parameters

id
string<uuid>
required

receipt_id, from POST /setup/apply or GET /setup/receipts

Body

application/json
dry_run
boolean
default:true

true (the default, also when the body is empty) shows what would be removed, restored and kept and changes nothing. false undoes the import.

Response

What the undo would do (dry_run true) or did (dry_run false)

receipt_id
string<uuid>
required
dry_run
boolean
required

True when nothing was changed.

file
object
required
counts
object
required
results
object[]
required
next
string

Present on a dry run. Says nothing was undone.