Delete Images

DELETE /api/images

Deletes one or more images from the photo frame collection. Requires admin authentication.

This is a protected endpoint. You must be logged in as admin to delete images.

Request

string[]

required

Array of image paths to delete (relative to uploads directory)

Request Example

Single Image

curl -X DELETE http://localhost:3000/api/images \
  -H "Content-Type: application/json" \
  -H "Cookie: session-cookie" \
  -d '{"images": ["vacation/2023/photo1.jpg"]}'

Multiple Images

curl -X DELETE http://localhost:3000/api/images \
  -H "Content-Type: application/json" \
  -H "Cookie: session-cookie" \
  -d '{"images": ["vacation/2023/photo1.jpg", "vacation/2023/photo2.png", "old-photos/sunset.jpg"]}'

Response

{
  "success": true,
  "message": "3 images deleted successfully",
  "data": {
    "deletedImages": [
      {
        "path": "vacation/2023/photo1.jpg",
        "status": "deleted",
        "size": 2048576
      },
      {
        "path": "vacation/2023/photo2.png",
        "status": "deleted", 
        "size": 1536000
      },
      {
        "path": "old-photos/sunset.jpg",
        "status": "deleted",
        "size": 3072000
      }
    ],
    "totalDeleted": 3,
    "totalSize": 6656576
  }
}

{
  "success": true,
  "message": "2 of 3 images deleted successfully",
  "data": {
    "deletedImages": [
      {
        "path": "vacation/2023/photo1.jpg",
        "status": "deleted",
        "size": 2048576
      },
      {
        "path": "vacation/2023/photo2.png",
        "status": "deleted",
        "size": 1536000
      },
      {
        "path": "missing/photo.jpg",
        "status": "not_found",
        "error": "File does not exist"
      }
    ],
    "totalDeleted": 2,
    "totalSize": 3584576
  }
}

{
  "success": false,
  "error": "No images specified for deletion",
  "code": "MISSING_IMAGES_PARAMETER"
}

Status Codes

Success

Images deleted successfully (may include partial failures)

Bad Request

Missing or invalid images parameter

Unauthorized

Admin authentication required

Server Error

File system error during deletion

JavaScript Example

async function deleteImages(imagePaths) {
  try {
    const response = await fetch('/api/images', {
      method: 'DELETE',
      headers: {
        'Content-Type': 'application/json'
      },
      credentials: 'include', // Include session cookie
      body: JSON.stringify({
        images: imagePaths
      })
    });
    
    const result = await response.json();
    
    if (result.success) {
      console.log(`Deleted ${result.data.totalDeleted} images`);
      
      // Check for any failures
      const failed = result.data.deletedImages.filter(img => img.status !== 'deleted');
      if (failed.length > 0) {
        console.warn('Some images could not be deleted:', failed);
      }
      
      return result.data.deletedImages;
    } else {
      throw new Error(result.error);
    }
  } catch (error) {
    console.error('Delete failed:', error);
    throw error;
  }
}

// Usage example
const imagesToDelete = [
  'vacation/2023/blurry-photo.jpg',
  'old-photos/duplicate.png'
];

deleteImages(imagesToDelete)
  .then(results => {
    console.log('Deletion complete:', results);
  })
  .catch(error => {
    console.error('Deletion failed:', error);
  });

Important Notes

Permanent Deletion: Deleted images cannot be recovered. Make sure you have backups if needed.

Image paths should be relative to the uploads directory
Use forward slashes for path separators
Non-existent files are reported but don’t cause the entire operation to fail
Empty folders are not automatically removed after deleting all contents
Deletion is permanent - there is no trash/recycle bin functionality

Bulk Operations

For deleting many images:

Consider breaking large batches into smaller chunks
Monitor server response times for large operations
Check the response for any partial failures
Failed deletions don’t stop the processing of remaining images

REST API

Authentication

Photos API

Folders API

DELETE /api/images

Request

Request Example

Response

Status Codes

JavaScript Example

Important Notes

Bulk Operations

​DELETE /api/images

​Request

​Request Example

​Response

​Status Codes

​JavaScript Example

​Important Notes

​Bulk Operations

DELETE /api/images

Request

Request Example

Response

Status Codes

JavaScript Example

Important Notes

Bulk Operations