Delete file

Permanently delete a file from both the database and cloud storage. This action cannot be undone.

Required parameter:

• mediaId: The unique ID of the file to delete

What happens when you delete:

1. File record is removed from the database
2. Actual file is deleted from cloud storage
3. All associated metadata is cleaned up
4. Deletion is logged for audit purposes

Security checks:

• You must have proper permissions for the file’s related item
• Only users in the same organization can delete files
• Critical files may be soft-deleted to preserve audit trails

⚠️ Before deleting, consider:

• Are any forms, dashboards, or reports using this file?
• Is this file required for compliance or regulatory purposes?
• Will deleting this affect other parts of the system?

Good reasons to delete:

• Remove outdated or incorrect documents
• Clean up test files or duplicates
• Comply with data retention policies
• Fulfill user requests for file removal