<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-images",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription images"
}
-->

# Subscription images

Create, modify, and delete promotion images for auto-renewable subscriptions.

## Topics

### Endpoints

[`Create a subscription image`](/documentation/AppStoreConnectAPI/POST-v2-subscriptionImages)

Reserve a promotion image for an auto-renewable subscription configured with the v2 API and prepare its asset upload.

[`Read subscription image information`](/documentation/AppStoreConnectAPI/GET-v2-subscriptionImages-_id_)

Get the metadata for a subscription image configured with the v2 API, including the asset upload state.

[`Modify a subscription image`](/documentation/AppStoreConnectAPI/PATCH-v2-subscriptionImages-_id_)

Commit the asset upload for a subscription image configured with the v2 API.

[`Delete a subscription image`](/documentation/AppStoreConnectAPI/DELETE-v2-subscriptionImages-_id_)

Delete a subscription image configured with the v2 API.

### Objects

[`object SubscriptionImageV2`](/documentation/AppStoreConnectAPI/SubscriptionImageV2)

A promotion image attached to an auto-renewable subscription configured with the v2 API.

[`object SubscriptionImageV2CreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionImageV2CreateRequest)

The request body you use to create a subscription image with the v2 API.

[`object SubscriptionImageV2Response`](/documentation/AppStoreConnectAPI/SubscriptionImageV2Response)

The response body for endpoints that create, read, or modify a subscription image with the v2 API.

[`object SubscriptionImageV2UpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionImageV2UpdateRequest)

The request body you use to commit an upload for a subscription image with the v2 API.

[`object SubscriptionImagesV2Response`](/documentation/AppStoreConnectAPI/SubscriptionImagesV2Response)

The response body for endpoints that list subscription images configured with the v2 API.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)