Permanently Delete File

Permanently Delete File

Permanently deletes a file from the system. This action cannot be undone.

Method: DELETE
URL: {{base_url}}/files/{{file_id}}/force

Authentication

This endpoint requires authentication.

• Recommended: Bearer token in the Authorization header:

Authorization: Bearer {{access_token}}

Notes:

• If your collection/folder already sets auth, this request can inherit auth.

• Ensure {{access_token}} is a valid, non-expired token.

Required variables

Set these variables at the environment or collection level:

Path Parameters

Example request URL:

{{base_url}}/files/34/force

Sample request

curl --request DELETE "{{base_url}}/files/{{file_id}}/force" \
  --header "Authorization: Bearer {{access_token}}"

Sample success response

A successful request typically returns HTTP 200 OK.

{
  "success": true,
  "message": "File permanently deleted"
}

Common errors

• 400 Bad Request

  • Invalid or missing file_id

• 401 Unauthorized / 403 Forbidden

  • Missing/invalid Authorization header

  • Expired {{access_token}}

• 404 Not Found

  • File with the given file_id does not exist

Notes

• This endpoint permanently deletes the file from the system and storage.

• The file cannot be restored after this operation.

• Typically used for files that are already in trash and need to be removed permanently.

• Use the Delete File (Move to Trash) endpoint first if you want a reversible deletion.