List Available macOS Versions for an Xcode Version
List all macOS versions available in Xcode Cloud that support a specific Xcode version.
URL
GET https://api.appstoreconnect.apple.com/v1/ciXcodeVersions/{id}/macOsVersionsPath Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the Xcode Versions resource. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[ciMacOsVersions] Optional | [string] | Additional fields to include for each macOS Versions resource returned by the response. |
fields[ciXcodeVersions] Optional | [string] | Additional fields to include for each macOS Versions resource returned by the response. |
include Optional | [string] | The relationship data to include in the response. |
limit Optional | integer | The number of macOS Versions resources to return. |
limit[xcodeVersions] Optional | integer | The number of included macOS Versions resources to return if the Xcode versions relationship is included. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CiMacOsVersionsResponse | The request completed successfully. |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | An error occurred with your request. |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | Request not authorized. |
| 404 | Not Found Content-Type: application/json | ErrorResponse | Resource not found. |
| 429 | Content-Type: application/json | ErrorResponse |
Discussion
The example request below lists macOS versions available for a specific Xcode version. Use the information provided in the response to update workflows, build dashboards, and more.