---
title: Delete Image
framework: retentionmessaging
role: symbol
role_heading: Web Service Endpoint
path: retentionmessaging/delete-image
---

# Delete Image

Deletes a previously uploaded image.

## URL

DELETE https://api.storekit.apple.com/inApps/v1/messaging/image/{imageIdentifier}

## Sandbox URL

DELETE https://api.storekit-sandbox.apple.com/inApps/v1/messaging/image/{imageIdentifier}

## Path Parameters

imageIdentifier: The identifier of the image to delete.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: The request is invalid and unacceptable. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests.. 403 Forbidden: The request is forbidden because the image is in use. 404 Not Found: The system can’t find the image. 429 : The request exceeded the rate limit. For more information, see Identifying rate limits. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

Identifying rate limits

## Discussion

Discussion Call this endpoint to delete an image. After successfully deleting the image, its imageIdentifier no longer exists. Don’t use the imageIdentifier of a deleted image in any new messages. note: When you include an image in a message, you need to delete the message before you can delete the image. This endpoint isn’t idempotent. If the system doesn’t find the image, this endpoint throws an error.

## See Also

### Image configuration

- [Upload Image](retentionmessaging/upload-image.md)
- [Get Image List](retentionmessaging/get-image-list.md)
- [GetImageListResponse](retentionmessaging/getimagelistresponse.md)
- [GetImageListResponseItem](retentionmessaging/getimagelistresponseitem.md)