<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/xcode-versions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Xcode Versions"
}
-->

# Xcode Versions

Read Xcode version information you configure for an Xcode Cloud workflow.

## Discussion

The `ciXcodeVersions` resource represents the version of Xcode you configure for an Xcode Cloud workflow.

To change a workflow’s build environment, 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 Xcode Version Information

[`List all xcode versions available in xcode cloud`](/documentation/AppStoreConnectAPI/GET-v1-ciXcodeVersions)

List all Xcode versions that are available to Xcode Cloud workflows.

[`Read xcode version information`](/documentation/AppStoreConnectAPI/GET-v1-ciXcodeVersions-_id_)

Get information about a specific Xcode version that’s available to Xcode Cloud workflows.

[`List available macos versions for an xcode version`](/documentation/AppStoreConnectAPI/GET-v1-ciXcodeVersions-_id_-macOsVersions)

List all macOS versions available in Xcode Cloud that support a specific Xcode version.

[`List macOS version IDs for a CI Xcode version`](/documentation/AppStoreConnectAPI/GET-v1-ciXcodeVersions-_id_-relationships-macOsVersions)

### Objects

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

An Xcode version available in Xcode Cloud for running workflow builds and tests.

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

The response body for endpoints that read a single Xcode version available in Xcode Cloud.

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

The response body for endpoints that list Xcode versions available for Xcode Cloud.

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


---

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)