Contents

List All macOS Versions Available in Xcode Cloud

List all macOS versions available to Xcode Cloud workflows.

URL

GET https://api.appstoreconnect.apple.com/v1/ciMacOsVersions

Query Parameters

NameTypeDescription
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 Optionalinteger

The number of macOS Versions resources to return.

limit[xcodeVersions] Optionalinteger

The number of included macOS Versions resources to return if the Xcode versions relationship is included.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
CiMacOsVersionsResponse

The request completed successfully.

400Bad Request
Content-Type: application/json
ErrorResponse

An error occurred with your request.

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

Request not authorized.

429
Content-Type: application/json
ErrorResponse

Discussion

The example request below lists macOS versions available to Xcode Cloud workflows. Use the information provided in the response to read additional data; for example, Xcode version information.

Example Request and Response

See Also

Getting macOS Version Information