Skip to main content
DELETE
Immediately purge a file

Authorizations

X-Api-Key
string
header
required

Your team API key (starts with al_live_).

Headers

Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-07-16 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-16"

Path Parameters

id
string
required

Opaque file ID.

Example:

"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"

Response

Deleted (or already deleted)

deleted
boolean
required

Always true on success (idempotent).

Example:

true

id
string
required

The file ID.

Example:

"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"

object
string
required

Object discriminator.

Example:

"file"