Delete File

Delete a file and all its variants from storage

DELETE /:projectId/api/v7/storage/:fileId

Delete File

cURL

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

Not Found — 404

{ "error": "File not found", "code": "storage/file-not-found" }

Unauthorized — 403

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

{ "error": "Unauthorized", "code": "storage/unauthorized" }