Skip to main content
DELETE
Delete File

Delete File

DELETE /files/{file_id} Permanently delete a file from the system. This operation removes the file completely and cannot be undone.

Features

  • Permanently deletes the file
  • File completely removed from system
  • Cannot be undone - use with caution
  • User ownership validation

Parameters

Request

Response

Response Fields

Important Notes

  • Irreversible: Deletion cannot be undone
  • Permanent Deletion: File is completely removed from the system
  • No Recovery: File cannot be recovered after deletion
  • Complete Removal: All file data and metadata are permanently deleted

Error Responses

  • 404 Not Found: File doesn’t exist or user doesn’t have access
  • 409 Conflict: File is already deleted
  • 403 Forbidden: User doesn’t own the file

Try It Out

Use the interactive playground above to test the delete file endpoint. You can:
  1. Add your API key in the Authorization header
  2. Enter a file ID in the path parameter (use a UUID from your uploaded files)
  3. Execute the request to permanently delete the file
⚠️ Warning: This operation cannot be undone. The file will be permanently removed from the system.

Authorizations

Authorization
string
header
required

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

Path Parameters

file_id
string<uuid>
required

Unique identifier of the file

Response

200 - application/json

File deleted successfully

success
boolean
Example:

true

data
object