Delete Media File

Deletes an existing file from the system. This will remove both the file record and the actual file from storage.

HTTP Request

DELETE/api/media/files/:id

Authorization

Authorization

• Required: Yes
• Permission: Staff with FilePermission or Admin
• Permission Code: 3804
• Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the file to delete

Example Requests

🐍 Python

1import requests
2
3response = requests.delete('http://www.example.com/api/media/files/123', 
4  headers={'Authorization': 'Token <your_api_key>'}
5)
6print(response.status_code)  # Should be 204 for successful deletion
7
8# Check if file was deleted
9if response.status_code == 204:
10  print("File deleted successfully")
11elif response.status_code == 404:
12  print("File not found")
13else:
14  print(f"Error: {response.status_code}")

🌐 Curl

1curl -X DELETE "http://www.example.com/api/media/files/123" \
2-H "Authorization: Token <your_api_key>" \
3-v

Response Fields

Field	Type	Description
None	None	No content returned on successful deletion