Skip to main content
DELETE
/
v1
/
files
/
{id}
Immediately purge a file
curl --request DELETE \
  --url https://api.aurous-labs.com/v1/files/{id} \
  --header 'X-Api-Key: <api-key>'
{
  "deleted": true,
  "id": "file_01HXMQ7Z3K8Y2NABCDEFGHJKMN",
  "object": "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-05-15 for unauthenticated requests.

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

"2026-05-15"

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"