---
title: Build Runs
framework: appstoreconnectapi
role: collectionGroup
role_heading: API Collection
path: appstoreconnectapi/build-runs
---

# Build Runs

Read detailed build information and start new builds.

## Overview

Overview 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 Determine the Appropriate Token Lifetime.

## Topics

### Getting Build Information

- [Read xcode cloud build information](appstoreconnectapi/get-v1-cibuildruns-_id_.md)
- [List all actions for an xcode cloud build](appstoreconnectapi/get-v1-cibuildruns-_id_-actions.md)
- [List all builds xcode cloud created in app store connect](appstoreconnectapi/get-v1-cibuildruns-_id_-builds.md)
- [List action IDs for a CI build run](appstoreconnectapi/get-v1-cibuildruns-_id_-relationships-actions.md)
- [List build IDs for a CI build run](appstoreconnectapi/get-v1-cibuildruns-_id_-relationships-builds.md)

### Starting a New Build

- [Start a build](appstoreconnectapi/post-v1-cibuildruns.md)

### Objects

- [CiBuildRun](appstoreconnectapi/cibuildrun.md)
- [CiBuildRunCreateRequest](appstoreconnectapi/cibuildruncreaterequest.md)
- [CiBuildRunResponse](appstoreconnectapi/cibuildrunresponse.md)
- [CiBuildActionsResponse](appstoreconnectapi/cibuildactionsresponse.md)
- [CiBuildRunActionsLinkagesResponse](appstoreconnectapi/cibuildrunactionslinkagesresponse.md)
- [CiBuildRunBuildsLinkagesResponse](appstoreconnectapi/cibuildrunbuildslinkagesresponse.md)

## See Also

### Build Information

- [Build Actions](appstoreconnectapi/build-actions.md)
- [Artifacts](appstoreconnectapi/artifacts.md)
- [Issues](appstoreconnectapi/issues.md)
- [Test Results](appstoreconnectapi/test-results.md)