<!--
{
  "availability" : [
    "App Store Connect API: 3.6.0 - 4.4.1"
  ],
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-images-v1",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription images (v1)"
}
-->

# Subscription images (v1)

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

## Discussion> Important:
> This is deprecated. Use <doc://com.apple.appstoreconnectapi/documentation/AppStoreConnectAPI/subscription-images> instead.

## Topics

### Endpoints

[`Create an image for a subscription (v1)`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionImages)

Reserve an image asset to appear in the App Store, representing a subscription.

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

Read details about a specific subscription image.

[`List Subscription Images`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-images)

List all images for a specific subscription.

[`List subscription image ids`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-images)

List all images IDs for a specific subscription.

[`Commit a subscription image (v1)`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionImages-_id_)

Commit an uploaded subscription image.

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

Delete the image asset that appears on the App Store listing that represents a subscription.

### Objects

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

An image used to represent a subscription product on the App Store product page.

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

The request body you use to create a subscription purchase image reservation.

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

A response containing a single subscription product image.

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

A response containing a list of images for a subscription product.

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

The request body for updating the upload status or content of a subscription product image.

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


---

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)