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

# Issues

Read information about issues that occurred when Xcode Cloud performs a build.

## Discussion

The `ciIssues` resource represents issues that occur when Xcode Cloud performs a build. Use it to access a list of issues that occurred and read detailed issue information; for example:

- The type of issue that occurred
- The location in your code where the issue occurred
- A message describing the issue

> 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 Cloud Build Issues

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

Get information about a specific issue that occurred when Xcode Cloud performed a build.

### Objects

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

A warning or error produced during an Xcode Cloud build action, associated with a source file location.

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

A source code location reference indicating the file path, line number, and column of an issue in an Xcode Cloud build.

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

The response body for endpoints that read a single issue from an Xcode Cloud build action.


---

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)