delete.mdx

title	Delete File
description	Permanently delete a previously uploaded file using its stored path.

DELETE /api/storage/file

Permanently removes a file from storage. You must provide the path value that was returned when the file was uploaded. This operation cannot be undone.

Required Headers

Header	Value
x-api-key	Your pk_live_… or sk_live_… key
Content-Type	application/json

Request Body

The storage path of the file to delete, in the format `PROJECT_ID/filename.ext`. This is the `path` field returned by the upload endpoint — not the public URL.

Response Fields

`true` when the file was deleted successfully. Human-readable confirmation message.

Code Examples

const res = await fetch('https://api.urbackend.in/api/storage/file', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'pk_live_YOUR_KEY'
  },
  body: JSON.stringify({
    path: 'PROJECT_ID/image.png'
  })
});

const { success, message } = await res.json();

curl -X DELETE "https://api.urbackend.in/api/storage/file" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_YOUR_KEY" \
  -d '{"path": "PROJECT_ID/image.png"}'

Success Response

{
  "success": true,
  "data": {},
  "message": "File deleted successfully"
}

Errors

Status	Cause
401 Unauthorized	Missing or invalid API key
404 Not Found	The path does not exist or the file was already deleted