Purge a file from all version history
DELETE/files/:fileKey/purge
Permanently and irrecoverably removes the file and all references to it across every process application version snapshot. Works on live and soft-deleted files. If the file row has already been permanently deleted, purge still removes any orphaned process application snapshot milestone references that point to the file by ID. Idempotent for files that never existed or have already been fully purged within the caller's organization.
Request
Responses
- 204
- 401
- 403
- 404
- 500
The file was purged, or was already absent. Once a file has been purged its ID is removed from all storage, so callers cannot distinguish between a file that was just purged, one that was purged in a previous call, and one that never existed — all three cases return 204.
The request lacks valid authentication credentials.
Response Headers
Forbidden. The request is not allowed.
The file belongs to a different organization and cannot be accessed.
An internal error occurred while processing the request.