<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/products",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Products"
}
-->

# Products

Read information about the products Xcode Cloud detected or delete a product and all its associated information.

## Discussion

The `ciProducts` resource represents the products <doc://com.apple.documentation/documentation/Xcode/Xcode-Cloud> detected when you started using Xcode Cloud. The resource includes information associated with the product like your app, workflows, builds, and Git repositories.

In addition to viewing your product and its associated information, you can use the `ciProducts` resource to delete a product and its associated data.

> Important:
> Deleting a product deletes all associated data, including build information like build artifacts, and can’t be undone.

This resource supports JSON web tokens with a lifetime of up to six months. For more information, see [Determine the Appropriate Token Lifetime](/documentation/AppStoreConnectAPI/generating-tokens-for-api-requests#Determine-the-Appropriate-Token-Lifetime).

## Topics

### Getting Xcode Cloud Products

[`List all xcode cloud products`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts)

Get a list of all products you created in Xcode Cloud.

[`Read xcode cloud product information`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_)

Get information about a specific Xcode Cloud product.

[`List all additional repositories for an xcode cloud product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-additionalRepositories)

List all additional Git repositories you associated with an Xcode Cloud product.

[`List additional repository IDs for a CI product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-relationships-additionalRepositories)

[`Read app information for an xcode cloud product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-app)

Get the app in App Store Connect that’s related to an Xcode Cloud product.

[`Get the app ID for a CI product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-relationships-app)

[`List all xcode cloud builds for an xcode cloud product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-buildRuns)

List all builds Xcode Cloud performed for a specific product.

[`List build run IDs for a CI product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-relationships-buildRuns)

[`List all primary git repositories for an xcode cloud product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-primaryRepositories)

List all primary Git repositories for a specific Xcode Cloud product.

[`List primary repository IDs for a CI product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-relationships-primaryRepositories)

[`List all workflows for an xcode cloud product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-workflows)

List all workflows for a specific Xcode Cloud product.

[`List workflow IDs for a CI product`](/documentation/AppStoreConnectAPI/GET-v1-ciProducts-_id_-relationships-workflows)

[`Read the xcode cloud product for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-ciProduct)

Get the Xcode Cloud product information for an app you build with Xcode Cloud.

### Deleting Xcode Cloud Products

[`Delete a product`](/documentation/AppStoreConnectAPI/DELETE-v1-ciProducts-_id_)

Delete an Xcode Cloud product and all of its associated workflows, builds, and artifacts.

### Objects

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

An app or framework registered in Xcode Cloud that has one or more workflows and build history.

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

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

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

The response body for endpoints that list Xcode Cloud products.

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

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

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

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

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

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

Settings for a start condition that starts a build if a branch changes.

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

Settings Xcode Cloud uses to determine whether a change should start a new build or not.

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

The Git identity (name and email) of the person who authored or committed the code change that triggered an Xcode Cloud build.

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

A summary of the warnings, errors, analyzer warnings, and test failures in an Xcode Cloud build run.

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

Settings for a start condition that starts a build if a pull request changes.

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

Settings for a start condition that starts a build based on a schedule.

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

Settings for a start condition that starts a build if a Git tag changes.

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

The test destination of a test action that Xcode Cloud performs.

[`string CiActionType`](/documentation/AppStoreConnectAPI/CiActionType)

A string that represents the type of an Xcode Cloud workflow’s action.

[`string CiCompletionStatus`](/documentation/AppStoreConnectAPI/CiCompletionStatus)

A string that represents the completion status of an Xcode Cloud build.

[`string CiExecutionProgress`](/documentation/AppStoreConnectAPI/CiExecutionProgress)

A string that represents the progress of an ongoing Xcode Cloud build.

[`string CiTestDestinationKind`](/documentation/AppStoreConnectAPI/CiTestDestinationKind)

The string that represents the kind of a test destination.

[`string CiTestStatus`](/documentation/AppStoreConnectAPI/CiTestStatus)

A string that represents test status information.



---

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)