# Build uploads Read metadata for app builds you upload to App Store Connect. ## Discussion Use this resource to upload and manage build uploads for your apps. Use the `BUILD_UPLOAD_STATE_UPDATED` webhook event type to get information about build upload status changes. To learn more, see [`WebhookEventType`](/documentation/AppStoreConnectAPI/WebhookEventType). The `buildUploads` resource represents the overall concept of the upload, whereas the `buildUploadFiles` resource represents the actual files that you upload. You can also use Xcode or Transporter to upload app binaries. To learn more, see [Transporter](https://apps.apple.com/us/app/transporter/id1450874784). To read information about your builds after a successful upload, use the [Builds](/documentation/AppStoreConnectAPI/builds) resource. ## Topics ### Managing build uploads [`List All Build Uploads for an App`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-buildUploads) Get a list of all build uploads for a specific app. [`List all build uploads ids for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-buildUploads) Get a list of all build upload Ids for a specific app. [`Read Build Upload Information`](/documentation/AppStoreConnectAPI/GET-v1-buildUploads-_id_) Get details about a specific build upload file for an app. [`Create a Build Upload`](/documentation/AppStoreConnectAPI/POST-v1-buildUploads) Add a new build upload to an app. [`Remove a Build Upload`](/documentation/AppStoreConnectAPI/DELETE-v1-buildUploads-_id_) Remove a specific build upload for an app. ### Reading and uploading build files [`Read Build Upload File Information`](/documentation/AppStoreConnectAPI/GET-v1-buildUploadFiles-_id_) Get details about a specific build upload file for a build upload. [`Read build upload file information for a build upload`](/documentation/AppStoreConnectAPI/GET-v1-buildUploads-_id_-buildUploadFiles) Get build upload file information for a specific build upload. [`Read the build upload file id for a build upload`](/documentation/AppStoreConnectAPI/GET-v1-buildUploads-_id_-relationships-buildUploadFiles) Get the build upload file ID for a specific build upload. [`Create a Reservation for a Build Upload File`](/documentation/AppStoreConnectAPI/POST-v1-buildUploadFiles) Reserve a build upload file for a specific build upload. [`Commit a Build Upload File`](/documentation/AppStoreConnectAPI/PATCH-v1-buildUploadFiles-_id_) Commit a build upload file to a specific build upload. ### Objects [`object BuildUpload`](/documentation/AppStoreConnectAPI/BuildUpload) A multi-file upload operation for submitting an app build to App Store Connect. [`object BuildUploadBuildUploadFilesLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildUploadBuildUploadFilesLinkagesResponse) A response containing the resource identifiers of upload files associated with a build upload. [`object BuildUploadCreateRequest`](/documentation/AppStoreConnectAPI/BuildUploadCreateRequest) The request body for initiating a build upload operation. [`object BuildUploadFile`](/documentation/AppStoreConnectAPI/BuildUploadFile) A single file upload record within a build upload operation, containing the upload URL and checksum for verification. [`object BuildUploadFileCreateRequest`](/documentation/AppStoreConnectAPI/BuildUploadFileCreateRequest) The request body for creating a file upload record within a build upload operation. [`object BuildUploadFileResponse`](/documentation/AppStoreConnectAPI/BuildUploadFileResponse) A response containing a single file upload record for a build upload. [`object BuildUploadFilesResponse`](/documentation/AppStoreConnectAPI/BuildUploadFilesResponse) A response containing a list of file upload records for a build upload operation. [`object BuildUploadFileUpdateRequest`](/documentation/AppStoreConnectAPI/BuildUploadFileUpdateRequest) The request body you use to commit a build upload file. [`object BuildUploadResponse`](/documentation/AppStoreConnectAPI/BuildUploadResponse) A response containing a single build upload operation record. [`object BuildUploadsResponse`](/documentation/AppStoreConnectAPI/BuildUploadsResponse) A response containing a list of build upload operations. [`string BuildUploadState`](/documentation/AppStoreConnectAPI/BuildUploadState) A string that represents the state of a build upload. [`object AppBuildUploadsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppBuildUploadsLinkagesResponse) A response containing the resource identifiers of builds associated with an app’s upload operations. [`object StateDetail`](/documentation/AppStoreConnectAPI/StateDetail) A resource describing import validation errors, warnings and information. [`object DeliveryFileUploadOperation`](/documentation/AppStoreConnectAPI/DeliveryFileUploadOperation) An upload operation descriptor containing the URL, HTTP method, and required headers for uploading a background asset file to Apple’s servers. --- Copyright © 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)