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

# Build Actions

Read information about actions you configured for an Xcode Cloud workflow and their related data such as artifacts, issues, or test results.

## Discussion

The `ciBuildActions` resource represents the actions Xcode Cloud performed when it built your project or workspace. Use it to read information about the actions Xcode Cloud performed during a build; for example:

- Type, name, and date information of the action
- Status information for an ongoing and completed action
- Artifacts created by the action
- Issues that occurred
- Detailed information about test results

To update a workflow’s actions, use the [Workflows](/documentation/AppStoreConnectAPI/workflows) resource.

> 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 Actions

[`Read build action information`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_)

Get information about a specific action Xcode Cloud performed as part of a build.

[`List all artifacts for a build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-artifacts)

List all artifacts Xcode Cloud created when it performed an action.

[`Read the xcode cloud build information for a build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-buildRun)

Get Xcode Cloud build information for a given build action.

[`List all issues for a build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-issues)

List all issues that occurred for a specific action that Xcode Cloud performed as part of a build.

[`List all test results for an xcode cloud test action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-testResults)

List all test results for a specific test action Xcode Cloud performed as part of a build.

[`List artifact IDs for a CI build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-relationships-artifacts)

[`Get the build run ID for a CI build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-relationships-buildRun)

[`List issue IDs for a CI build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-relationships-issues)

[`List test result IDs for a CI build action`](/documentation/AppStoreConnectAPI/GET-v1-ciBuildActions-_id_-relationships-testResults)

### Objects

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

The execution result of a specific action step within an Xcode Cloud build run, including its status and issues.

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

The response body for endpoints that list artifacts produced by an Xcode Cloud build action.

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

The response body for endpoints that read a single Xcode Cloud build action.

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

The response body for endpoints that list issues from an Xcode Cloud build action.

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

The response body for endpoints that list test results from an Xcode Cloud build action.

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

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

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

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



---

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)