Overview
Permanently deletes a file you uploaded with Upload File. Pass the id returned by the presign step. A successful delete removes the stored object, so the file’s public_url stops resolving.
Deletes are idempotent — deleting a file that’s already gone returns the same 204 No Content.
Endpoint
Path Parameters
| Parameter | Type | Required | Description |
|---|
id | string (UUID) | Yes | The file id returned by Upload File — the id field of the presign response. |
Code Examples
Response
A successful delete returns 204 No Content with an empty body.
Error Responses
| Status | Body | Description |
|---|
400 | {"error": "invalid argument"} | id is not a valid UUID. |
401 | {} | Missing or invalid API key. |
404 | {"error": "file not found"} | No such file in your organization. |
409 | {"error": "conflict"} | The file is still being processed and isn’t in a deletable state yet. Retry once the upload has finished. |
Deletes are permanent and idempotent. A successful delete removes the stored object, so any public_url for the file stops resolving. Deleting a file that was already deleted — or never existed in your account — also returns 204.
