<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-asset-library-videos",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Asset Library videos"
}
-->

# App Asset Library videos

Upload and manage video assets in an app’s asset library.

## Discussion

The `appAssetLibraryVideos` resource represents a video asset in an app’s asset library that you can reuse across App Store surfaces through placements. Use it to:

- Upload a new video asset.
- Read a video asset and its review and processing state.
- Update a video asset.
- Delete a video asset.
- List the placements that reuse a video asset.

A video asset moves through a series of states as it uploads and goes through review. For video requirements, see [App preview specifications](https://developer.apple.com/help/app-store-connect/reference/app-preview-specifications).

## Topics

### Getting videos and reading information

[`Read an app asset library video`](/documentation/AppStoreConnectAPI/GET-v1-appAssetLibraryVideos-_id_)

Get information about an app asset library video.

[`List related placements`](/documentation/AppStoreConnectAPI/GET-v1-appAssetLibraryVideos-_id_-placements)

List the placements that reuse an app asset library video.

[`List the placement IDs for an app asset library video`](/documentation/AppStoreConnectAPI/GET-v1-appAssetLibraryVideos-_id_-relationships-placements)

Get a list of placement resource IDs for a specific app asset library video.

### Creating, modifying, and deleting videos

[`Create an app asset library video`](/documentation/AppStoreConnectAPI/POST-v1-appAssetLibraryVideos)

Create an app asset library video.

[`Modify an app asset library video`](/documentation/AppStoreConnectAPI/PATCH-v1-appAssetLibraryVideos-_id_)

Update an app asset library video.

[`Delete an app asset library video`](/documentation/AppStoreConnectAPI/DELETE-v1-appAssetLibraryVideos-_id_)

Delete an app asset library video.

### Objects and types

[`string AppAssetLibraryMediaType`](/documentation/AppStoreConnectAPI/AppAssetLibraryMediaType)

String that represents the media type of an app asset library asset.

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

A video asset uploaded to an app’s asset library that you can reuse across App Store surfaces through placements.

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

The request body you use to create an app asset library video.

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

The request body you use to update an app asset library video.

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

The response body for endpoints that create, read, or modify an app asset library video.

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

A response body that contains a list of related resource IDs.

### Asset state attributes

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

The attributes common to an app asset library video in any state.

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

The attributes of an app asset library video that’s in the awaiting upload state.

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

The attributes of an app asset library video that’s in the upload complete state.

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

The attributes of an app asset library video that’s in the ready for review state.

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

The attributes of an app asset library video that’s in the waiting for review state.

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

The attributes of an app asset library video that’s in the in review state.

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

The attributes of an app asset library video that’s in the accepted state.

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

The attributes of an app asset library video that’s in the approved state.

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

The attributes of an app asset library video that’s in the rejected state.

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

The attributes of an app asset library video that’s in the failed state.

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

The attributes of an app asset library video that’s in the archived state.



---

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)