Skip to main content
DELETE
Delete File
Deletes a file record and removes all associated storage objects. For image files, all generated variants are also deleted. Requires an authenticated user. Delete is owner-or-service: a user token may only delete files it owns; service/master keys may delete any file in the project. Backend-owned files (uploaded without a userId) are deletable only with a service/master key. Rate limit: 50 requests per 5 minutes.

Path Parameters

fileId
string
required
The UUID of the file to delete.

Response

deletedPaths lists all storage paths that were removed, including the original file and any image variants.

Error Responses

Returned when a user token attempts to delete a file it does not own.