6.6. Deleting images

DELETE /v2/images/{image_id}

Delete an image with the specified ID.


  • You can delete an image in any status except deleted.
  • The protected attribute of the image cannot be true.
  • You must be allowed to delete images by the image deletion policy.

Source: https://docs.openstack.org/api-ref/image/v2/index.html?expanded=#delete-image

6.6.1. Request

Name In Type Description
image_id path string The UUID of the image. Example

# curl -ks -X DELETE -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \

6.6.2. Response Status codes Success

Code Reason
204 - No Content The server has fulfilled the request. Error

Code Reason
400 - Bad Request Some content in the request was invalid.
401 - Unauthorized User must authenticate before making a request.
403 - Forbidden Policy does not allow current user to do this operation.
404 - Not Found The requested resource could not be found.
409 - Conflict This operation conflicted with another operation on this resource.