Skip to main content
DELETE
/
:projectId
/
api
/
v7
/
storage
/
:fileId
Delete File
curl --request DELETE \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/storage/:fileId
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

{
  "message": "File deleted successfully",
  "fileId": "uuid",
  "deletedPaths": [
    "images/abc123/original.webp",
    "images/abc123/thumbnail_original.webp",
    "images/abc123/medium_original.webp"
  ]
}
deletedPaths lists all storage paths that were removed, including the original file and any image variants.

​
Error Responses

{ "error": "File not found", "code": "storage/file-not-found" }
Returned when a user token attempts to delete a file it does not own.
{ "error": "Unauthorized", "code": "storage/unauthorized" }