Delete File
Deletes a file by its ID.
warning
Deleting a file is permanent and cannot be undone. The file will be removed from both the database and storage.
Endpoint
DELETE /api/files/:fileId
Authentication
Requires API Key authentication.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fileId | string | Yes | File ID |
Response
Returns a success confirmation.
{
"success": true,
"data": {
"success": true
}
}
Example
curl -X DELETE "https://api.silentwitness.ai/api/files/file_abc123def456" \
-H "X-API-Key: $API_KEY"
Errors
| Code | Description |
|---|---|
| 401 | Unauthorized - Invalid or missing token |
| 403 | Forbidden - Access denied to this file |
| 404 | File not found |
| 500 | Internal server error |
Example Error
{
"success": false,
"error": "File not found"
}
Notes
- Files used in completed analyses may still be referenced in reports
- Consider the impact on existing analyses before deleting files