---
title: "PATCH /v1/builds/{id}"
method: PATCH
path: "/v1/builds/{id}"
tags: ["Builds"]
---

# PATCH /v1/builds/{id}

`PATCH /v1/builds/{id}`

## Request body

- BuildUpdateRequest
  - `data` object, required
    - `attributes` object
      - `expired` boolean
      - `usesNonExemptEncryption` boolean
    - `id` string, required
    - `relationships` object
      - `appEncryptionDeclaration` object
        - `data` object
          - `id` string, required
          - `type` 'appEncryptionDeclarations', required
    - `type` 'builds', required

## Response `200`

Single Build

- BuildResponse
  - `data` Build, required
    - `attributes` object
      - `expirationDate` string, date-time
      - `expired` boolean
      - `iconAssetToken` ImageAsset
        - `height` integer
        - `templateUrl` string
        - `width` integer
      - `minOsVersion` string
      - `processingState` 'PROCESSING' | 'FAILED' | 'INVALID' | 'VALID'
      - `uploadedDate` string, date-time
      - `usesNonExemptEncryption` boolean
      - `version` string
    - `id` string, required
    - `links` ResourceLinks, required
      - `self` string, uri-reference, required
    - `relationships` object
      - `app` object
        - `data` object
          - `id` string, required
          - `type` 'apps', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `appEncryptionDeclaration` object
        - `data` object
          - `id` string, required
          - `type` 'appEncryptionDeclarations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `appStoreVersion` object
        - `data` object
          - `id` string, required
          - `type` 'appStoreVersions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `betaAppReviewSubmission` object
        - `data` object
          - `id` string, required
          - `type` 'betaAppReviewSubmissions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `betaBuildLocalizations` object
        - `data` object[]
          - `id` string, required
          - `type` 'betaBuildLocalizations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `buildBetaDetail` object
        - `data` object
          - `id` string, required
          - `type` 'buildBetaDetails', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `icons` object
        - `data` object[]
          - `id` string, required
          - `type` 'buildIcons', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `individualTesters` object
        - `data` object[]
          - `id` string, required
          - `type` 'betaTesters', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `preReleaseVersion` object
        - `data` object
          - `id` string, required
          - `type` 'preReleaseVersions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
    - `type` 'builds', required
  - `included` union[]
    - union
      - PrereleaseVersion
        - `attributes` object
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `version` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'preReleaseVersions', required
      - BetaTester
        - `attributes` object
          - `email` string, email
          - `firstName` string
          - `inviteType` 'EMAIL' | 'PUBLIC_LINK'
          - `lastName` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `apps` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaGroups` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'betaTesters', required
      - BetaBuildLocalization
        - `attributes` object
          - `locale` string
          - `whatsNew` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `build` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'betaBuildLocalizations', required
      - AppEncryptionDeclaration
        - `attributes` object
          - `appEncryptionDeclarationState` 'IN_REVIEW' | 'APPROVED' | 'REJECTED' | 'INVALID' | 'EXPIRED'
          - `availableOnFrenchStore` boolean
          - `codeValue` string
          - `containsProprietaryCryptography` boolean
          - `containsThirdPartyCryptography` boolean
          - `documentName` string
          - `documentType` string
          - `documentUrl` string
          - `exempt` boolean
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `uploadedDate` string, date-time
          - `usesEncryption` boolean
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appEncryptionDeclarations', required
      - BetaAppReviewSubmission
        - `attributes` object
          - `betaReviewState` 'WAITING_FOR_REVIEW' | 'IN_REVIEW' | 'REJECTED' | 'APPROVED'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `build` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'betaAppReviewSubmissions', required
      - App
        - `attributes` object
          - `availableInNewTerritories` boolean
          - `bundleId` string
          - `contentRightsDeclaration` 'DOES_NOT_USE_THIRD_PARTY_CONTENT' | 'USES_THIRD_PARTY_CONTENT'
          - `isOrEverWasMadeForKids` boolean
          - `name` string
          - `primaryLocale` string
          - `sku` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appInfos` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `availableTerritories` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaAppLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaAppReviewDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaGroups` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaLicenseAgreement` object
            - `data` object
              - …
            - `links` object
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `endUserLicenseAgreement` object
            - `data` object
              - …
            - `links` object
              - …
          - `gameCenterEnabledVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `inAppPurchases` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `preOrder` object
            - `data` object
              - …
            - `links` object
              - …
          - `preReleaseVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `prices` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'apps', required
      - BuildBetaDetail
        - `attributes` object
          - `autoNotifyEnabled` boolean
          - `externalBuildState` 'PROCESSING' | 'PROCESSING_EXCEPTION' | 'MISSING_EXPORT_COMPLIANCE' | 'READY_FOR_BETA_TESTING' | 'IN_BETA_TESTING' | 'EXPIRED' | 'READY_FOR_BETA_SUBMISSION' | 'IN_EXPORT_COMPLIANCE_REVIEW' | 'WAITING_FOR_BETA_REVIEW' | 'IN_BETA_REVIEW' | 'BETA_REJECTED' | 'BETA_APPROVED'
          - `internalBuildState` 'PROCESSING' | 'PROCESSING_EXCEPTION' | 'MISSING_EXPORT_COMPLIANCE' | 'READY_FOR_BETA_TESTING' | 'IN_BETA_TESTING' | 'EXPIRED' | 'IN_EXPORT_COMPLIANCE_REVIEW'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `build` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'buildBetaDetails', required
      - AppStoreVersion
        - `attributes` object
          - `appStoreState` 'DEVELOPER_REMOVED_FROM_SALE' | 'DEVELOPER_REJECTED' | 'IN_REVIEW' | 'INVALID_BINARY' | 'METADATA_REJECTED' | 'PENDING_APPLE_RELEASE' | 'PENDING_CONTRACT' | 'PENDING_DEVELOPER_RELEASE' | 'PREPARE_FOR_SUBMISSION' | 'PREORDER_READY_FOR_SALE' | 'PROCESSING_FOR_APP_STORE' | 'READY_FOR_SALE' | 'REJECTED' | 'REMOVED_FROM_SALE' | 'WAITING_FOR_EXPORT_COMPLIANCE' | 'WAITING_FOR_REVIEW' | 'REPLACED_WITH_NEW_VERSION'
          - `copyright` string
          - `createdDate` string, date-time
          - `downloadable` boolean
          - `earliestReleaseDate` string, date-time
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `releaseType` 'MANUAL' | 'AFTER_APPROVAL' | 'SCHEDULED'
          - `usesIdfa` boolean
          - `versionString` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `ageRatingDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreReviewDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersionLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersionPhasedRelease` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersionSubmission` object
            - `data` object
              - …
            - `links` object
              - …
          - `build` object
            - `data` object
              - …
            - `links` object
              - …
          - `idfaDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `routingAppCoverage` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appStoreVersions', required
      - BuildIcon
        - `attributes` object
          - `iconAsset` ImageAsset
            - `height` integer
            - `templateUrl` string
            - `width` integer
          - `iconType` 'APP_STORE' | 'MESSAGES_APP_STORE' | 'WATCH_APP_STORE' | 'TV_OS_HOME_SCREEN' | 'TV_OS_TOP_SHELF'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'buildIcons', required
      - PerfPowerMetric
        - `attributes` object
          - `deviceType` string
          - `metricType` 'DISK' | 'HANG' | 'BATTERY' | 'LAUNCH' | 'MEMORY' | 'ANIMATION' | 'TERMINATION'
          - `platform` 'IOS'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'perfPowerMetrics', required
      - DiagnosticSignature
        - `attributes` object
          - `diagnosticType` 'DISK_WRITES'
          - `signature` string
          - `weight` number
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'diagnosticSignatures', required
  - `links` DocumentLinks, required
    - `self` string, uri-reference, required

## Other responses

- `400` — Parameter error(s)
- `403` — Forbidden error
- `404` — Not found error
- `409` — Request entity error(s)

---

[API](https://skmtc.net/apple/apis/app-store-connect.md) · [All operations](https://skmtc.net/apple/apis/app-store-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apple/app-store-connect/versions/e085db5c8896/schema)