Skip to main content
DELETE
Requires version 2.0.0 or later of the Archetype platform.

Overview

This endpoint permanently deletes the bytes and metadata of a file, looked up by the file’s file_uid (a value starting with fil_) instead of by its filename. It otherwise behaves like Delete File. The deletion is synchronous. Once the response is returned, the file no longer appears in listings, and its filename can be reused by a new upload. The new upload gets a new file_uid. Deleting a file requires the developer or admin role; callers with the viewer role receive an HTTP 403 error. Only registered or corrupt files can be deleted. A file whose direct upload is still in progress isn’t visible to this endpoint and returns an HTTP 404 error; cancel it with Abort Upload instead. Files you can’t see, files that are already deleted, and values that aren’t a file_uid also return an HTTP 404 error.

Path Parameters

string
required
The file’s file_uid (fil_...), as returned by the upload endpoints and in every file metadata record.

Response

boolean
required
true when the file is gone. Failures are reported through an HTTP error status code.
string
required
The filename of the deleted file
string
required
The file_uid of the deleted file