inboxes > files
Delete File
Changed onDeletes 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.
delete/v0/inboxes/{inbox_id}/files/{file_id}
Request
- Base URLhttps://api.agentmail.to
- URLhttps://api.agentmail.to/v0/inboxes/{inbox_id}/files/{file_id}
- AuthHTTP bearer
Path parameters
inbox_idstring required
The ID of the inbox.
file_idstring required
ID of the file. A UUID.
Response
Successful response
Changes
- info
endpoint added
- info