Skip to main content
DELETE
/
api
/
v1
/
files
/
{file_id}
curl -X DELETE "https://api.fileguard.io/api/v1/files/file_z1x2c3v4b5n6" \
  -H "Authorization: Bearer fg_your_api_key"

{
  "status": "SUCCESS",
  "message": "File deleted successfully",
  "data": {
    "file_id": "file_z1x2c3v4b5n6",
    "deleted": true
  },
  "timestamp": "2026-01-04T10:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://fileguard.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Soft delete a file. The file is marked as deleted but not physically removed.

​
Path Parameters

​
file_id
string
required
Unique file identifier
curl -X DELETE "https://api.fileguard.io/api/v1/files/file_z1x2c3v4b5n6" \
  -H "Authorization: Bearer fg_your_api_key"

{
  "status": "SUCCESS",
  "message": "File deleted successfully",
  "data": {
    "file_id": "file_z1x2c3v4b5n6",
    "deleted": true
  },
  "timestamp": "2026-01-04T10:00:00Z"
}

​
Required Scope

Requires delete scope on your API key.

​
Soft Delete

Files are soft-deleted (marked as deleted but not physically removed). This allows for:
  • Audit trails - Track what was deleted and when
  • Potential recovery - Files can be restored if needed
  • Compliance - Meet regulatory requirements for data retention