Delete API

The Delete API supports deleting files in CloudFlare ImgBed, including single file, folder, and batch file deletion functionality.

Basic Information

• Endpoint: /api/manage/delete/{path}
• Method: GET
• Authentication: delete privileges required
• Content Type: application/json

Request Parameters

Path Parameters

Parameter	Type	Required	Description
path	string	Yes	File path or folder path(e.g., file.png or your/folder)

Query Parameters

Parameter	Type	Required	Default	Description
folder	boolean	No	false	Whether it's a folder deletion, true means delete entire folder and its contents

Functionality

Single File Deletion

When the folder parameter is false or not provided, deletes the specified single file.

Folder Deletion

When the folder parameter is true, recursively deletes the specified folder and all its subfolders and files.

Batch File Deletion

Use the batch deletion endpoint to delete multiple files in one request. Files are deleted concurrently.

Basic Information

• Endpoint: /api/manage/delete/batch
• Method: POST
• Authentication: delete privileges required
• Content Type: application/json

Request Body

Parameter	Type	Required	Description
fileIds	string[]	Yes	List of file paths to delete; up to 500 files per request, duplicate paths are processed only once

{
  "fileIds": [
    "folder/image1.jpg",
    "folder/image2.png"
  ]
}

Response Format

Single File Deletion Success Response

{
  "success": true,
  "fileId": "example/image.jpg"
}

Folder Deletion Success Response

{
  "success": true,
  "deleted": [
    "folder/image1.jpg",
    "folder/image2.png",
    "folder/subfolder/image3.gif"
  ],
  "failed": []
}

Batch Deletion Success Response

{
  "success": true,
  "deleted": [
    "folder/image1.jpg",
    "folder/image2.png"
  ],
  "failed": []
}

Partial Batch Deletion Failure Response

When some files cannot be deleted, success is false and failed contains each failed file and its reason.

{
  "success": false,
  "deleted": ["folder/image1.jpg"],
  "failed": [
    {
      "fileId": "folder/image2.png",
      "error": "Delete file failed"
    }
  ]
}

Error Response

{
  "success": false,
  "error": "Delete file failed"
}

Examples

Delete Single File

curl --location --request GET 'https://your.domain/api/manage/delete/example,image.jpg' \
--header 'Authorization: Bearer your_token'

Delete Folder

curl --location --request GET 'https://your.domain/api/manage/delete/example,folder?folder=true' \
--header 'Authorization: Bearer your_token'

Batch Delete Files

curl --location --request POST 'https://your.domain/api/manage/delete/batch' \
--header 'Authorization: Bearer your_token' \
--header 'Content-Type: application/json' \
--data '{
  "fileIds": [
    "folder/image1.jpg",
    "folder/image2.png"
  ]
}'