Cancel an unbound encrypted tenant backup upload

POST

/api/admin/tenant-backups/uploads/{uploadId}/cancel

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/admin/tenant-backups/uploads/example/cancel \
  --header 'Authorization: Bearer <token>'

Requires backup read, manage, and import permissions plus fresh human administrator authentication. The actor-owned upload moves to asynchronous R2 cleanup. An upload already pinned by an import operation cannot be cancelled through this route.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

uploadId

required

string

/^[A-Za-z0-9_.:-]{1,256}$/

Responses

202

Upload cleanup is queued.

Media type application/json

object

id

required

string

state

required

string

Allowed value: cancelling

key

additional properties

Example

{
  "state": "cancelling"
}

400

Invalid upload identifier

403

Missing permission or fresh administrator authentication

409

Upload ownership

503

Import storage or audit persistence is unavailable