<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-screenshots",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Screenshots"
}
-->

# App Screenshots

Upload and download app screenshots for an app locale and display target.

## Discussion

An `appScreenshots` resource represents a single app screenshot for an app locale and display target. Use this resource to:

- Upload new app screenshots to App Store Connect.
- Download existing screenshots.

> Important:
> This resource is deprecated. Use the [App Asset Library](doc://com.apple.appstoreconnectapi/documentation/AppStoreConnectAPI/app-asset-library) and [placements](doc://com.apple.appstoreconnectapi/documentation/AppStoreConnectAPI/app-asset-library-placements) instead.

To upload screenshots, begin by creating an [App Screenshot Sets](/documentation/AppStoreConnectAPI/app-screenshot-sets) resource for the locale and display target. To upload screenshots, you must create an asset reservation, then follow the upload operations specified in the response.

> Important:
> Some screenshot sizes are required in order to submit your app for review. You’ll get an error at submission time if you don’t provide all of the required assets. For information about screenshot requirements, see [Screenshot specifications](https://developer.apple.com/help/app-store-connect/reference/screenshot-specifications).

## Topics

### Getting Screenshots and Reading Information

[`List all app screenshots for an app screenshot set`](/documentation/AppStoreConnectAPI/GET-v1-appScreenshotSets-_id_-appScreenshots)

List all ordered screenshots in a screenshot set.

[`Read app screenshot information`](/documentation/AppStoreConnectAPI/GET-v1-appScreenshots-_id_)

Get information about an app screenshot and its upload and processing status.

### Creating, Modifying, and Deleting Screenshots

[`Create an app screenshot`](/documentation/AppStoreConnectAPI/POST-v1-appScreenshots)

Add a new screenshot to a screenshot set.

[`Modify an app screenshot`](/documentation/AppStoreConnectAPI/PATCH-v1-appScreenshots-_id_)

Commit an app screenshot after uploading it.

[`Delete an app screenshot`](/documentation/AppStoreConnectAPI/DELETE-v1-appScreenshots-_id_)

Delete an app screenshot that is associated with a screenshot set.

### Objects

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

The data structure that represent an App Screenshots resource.

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

The request body you use to create an App Screenshot.

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

The request body you use to update an App Screenshot.

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

The response body for endpoints that create, read, or modify an app screenshot.

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

The response body for endpoints that list screenshots in an app screenshot set.

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

Upload instructions for assets such as app previews and app screenshots.


---

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)