Skip to navigation

Delete File

Beta

Deletes a file, pending or ready, and frees its path at once. Its bytes are deleted, and its space given back to the organization’s quota, within seconds. A download URL signed before the delete keeps working until it expires, at most an hour. Deleting a file that is already gone returns 404.

Requires the file_delete permission. Only a key with file_read, or the key that created the file, can delete it; any other key gets 404.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inbox_idstringRequired
The ID of the inbox.
file_idstringRequired
ID of the file. A UUID.

Errors

400
Validation Error
403
File Forbidden Error
404
Not Found Error