Delete image from storage

Delete an image file from Cloudflare R2 storage. Includes security checks to ensure the file belongs to the specified workspace.

DELETE

https://api.channelautomation.com/api/media/delete

Authorization

bearerAuth
optional
bearerAuth

apiKey
optional
apiKey

Request body JSON required

fileName
string
required
File name/key to delete
workspaceId
string
required
Workspace ID for authorization

Returns

200

Image deleted successfully

JSON

success
optional
boolean
Whether the deletion was successful
fileName
optional
string
Name of the deleted file

400

Bad request

JSON

success
optional
boolean
error
optional
string
Error message

403

Unauthorized - file doesn't belong to workspace

JSON

success
optional
boolean
error
optional
string
Error message

500

Server error

JSON

success
optional
boolean
error
optional
string
Error message

Delete image from storage

curl --request DELETE \
  --url https://api.channelautomation.com/api/media/delete \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "sequences/workspace123/abc123-def456.jpg",
  "workspaceId": "workspace-123"
}
'

const url = 'https://api.channelautomation.com/api/media/delete';
const options = {
  method: 'DELETE',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    fileName: 'sequences/workspace123/abc123-def456.jpg',
    workspaceId: 'workspace-123'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/media/delete"

payload = {
    "fileName": "sequences/workspace123/abc123-def456.jpg",
    "workspaceId": "workspace-123"
}
headers = {"Content-Type": "application/json"}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "success": true,
  "fileName": "sequences/workspace123/abc123-def456.jpg"
}

{
  "success": false,
  "error": "File name is required"
}

{
  "success": false,
  "error": "Unauthorized: File does not belong to this workspace"
}

{
  "success": false,
  "error": "Failed to delete image"
}