<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/build-runs",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Build Runs"
}
-->

# Build Runs

Read detailed build information and start new builds.

## Discussion

The `ciBuildRuns` resource represents an Xcode Cloud build. Use it to get a list of builds Xcode Cloud performed and access detailed information for a specific build; for example:

- The status of ongoing and completed builds
- The number of issues Xcode Cloud encountered during the build
- The build number
- Start and completion dates
- Actions Xcode Cloud performed

Additionally, use the `ciBuildRuns` resource to tell Xcode Cloud to start a new build.

> Note:
> This resource supports JSON web tokens with a lifetime of up to six months. For more information, see <doc://com.apple.appstoreconnectapi/documentation/AppStoreConnectAPI/generating-tokens-for-api-requests#Determine-the-Appropriate-Token-Lifetime>.

## Topics

### Getting Build Information

[`GET /v1/ciBuildRuns/{id}`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildRuns-_id_)

Get information about a specific Xcode Cloud build.

[`GET /v1/ciBuildRuns/{id}/actions`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildRuns-_id_-actions)

List all actions Xcode Cloud performed during a specific build.

[`GET /v1/ciBuildRuns/{id}/builds`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildRuns-_id_-builds)

List All App Store Connect and TestFlight Builds when it performed a build.

[`GET /v1/ciBuildRuns/{id}/relationships/actions`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildRuns-_id_-relationships-actions)

[`GET /v1/ciBuildRuns/{id}/relationships/builds`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildRuns-_id_-relationships-builds)

### Starting a New Build

[`POST /v1/ciBuildRuns`](/documentation/AppStoreConnectAPI/POST-v1-ciBuildRuns)

Start a new Xcode Cloud build for a workflow.

### Objects

[`CiBuildRun`](/documentation/AppStoreConnectAPI/CiBuildRun)

A single execution of an Xcode Cloud workflow, capturing the trigger, commit, status, and artifacts produced.

[`CiBuildRunCreateRequest`](/documentation/AppStoreConnectAPI/CiBuildRunCreateRequest)

The request body you use to start a new Xcode Cloud build.

[`CiBuildRunResponse`](/documentation/AppStoreConnectAPI/CiBuildRunResponse)

The response body for endpoints that start or read a single Xcode Cloud build run.

[`CiBuildActionsResponse`](/documentation/AppStoreConnectAPI/CiBuildActionsResponse)

The response body for endpoints that list actions for an Xcode Cloud build run.

[`CiBuildRunActionsLinkagesResponse`](/documentation/AppStoreConnectAPI/CiBuildRunActionsLinkagesResponse)

[`CiBuildRunBuildsLinkagesResponse`](/documentation/AppStoreConnectAPI/CiBuildRunBuildsLinkagesResponse)


---

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)