Skip to main content

DeleteFile removes a file.

DELETE 
/api/v1/uploads/:id

Performs soft delete by default. Hard delete requires admin permission. Soft-deleted files are permanently removed after retention period.

Parameters​

  • id: Required, file UUID
  • permanent: Optional, hard delete (admin only)

Side Effects​

  • Soft delete: Sets status to "deleted"
  • Hard delete: Removes from cloud storage and database

Errors​

  • NOT_FOUND: File does not exist
  • PERMISSION_DENIED: Caller lacks uploads:delete permission or lacks admin permission for permanent delete

Request​

Responses​

A successful response.