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

# macOS Versions

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

## Discussion

The `ciMacOsVersions` resource represents the version of macOS 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 macOS Version Information

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

List all macOS versions available to Xcode Cloud workflows.

[`Read macos version information`](/documentation/AppStoreConnectAPI/GET-v1-ciMacOsVersions-_id_)

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

[`List available xcode versions for a macos version`](/documentation/AppStoreConnectAPI/GET-v1-ciMacOsVersions-_id_-xcodeVersions)

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

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

### Objects

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

A macOS version available in Xcode Cloud infrastructure for running workflow builds.

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

A response containing a single macOS version available in Xcode Cloud.

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

A response containing a list of macOS versions supported by Xcode Cloud.

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


---

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)