The Jira and Jira Align Integration works by Jira Align sending outbound rest API calls from Jira Align to Jira to sync issues, boards, sprints, and fix versions between the applications. A couple of Jira rest API calls can be utilized to help configure the connector and to troubleshoot common sync errors.
/rest/api/2/serverInfo?doHealthCheck=true
Ex: customer.atlassian.net/rest/api/2/serverInfo?doHealthCheck=true
This call is the health check the Jira and Jira Align integration utilizes to validate API connectivity between Jira and Jira Align. This API calls does not require authentication to receive a response from Jira and for this reason Jira Align does not send an authentication header with this API call. Under Jira Align Admin > Jira Settings > Jira Connectors there is a “Test Now” button that utilizes this API call to validate connectivity between Jira and Jira Align. If you utilize an API Gateway or Reverse Proxy to connect Jira and Jira Align that requires credentials on inbound calls it will lead to this call failing as it does not send credentials.
/rest/api/latest/issue/(issue key)
Ex: customer.atlassian.net/rest/api/latest/issue/A-1
This call will return information on the referenced Jira issue such as present fields and their values, the resolution date, and current issue status. This call is useful for determining if a field is present on a Jira issue’s screen, pulling the resolution date field name and current value, checking the status ID of an issue’s current status, and validating the type of an issue. This call is helpful when an update did not sync from Jira to Jira Align or there is a sync error from Jira Align to Jira. An example would be finding the current status of a Jira issue to verify its ID and the corresponding Jira to Jira Align status mapping configurations.
/rest/api/latest/project/(project key)
Ex: customer.atlassian.net/rest/api/latest/project/A
This call will return information on the referenced Jira project such as its name, type, issue types, and Fix Versions. This call is extremely useful for pulling all the Fix Versions from a Jira Project and verifying their start and release date. When executing this API call from the API service account you can also verify that the API service account has permission access to view a particular Jira Project and access its Fix Versions.
/rest/agile/1.0/board/(board id)/sprint
Ex: customer.atlassian.net/rest/agile/1.0/board/111/sprint
Ex: customer.atlassian.net/rest/agile/1.0/board/111/sprint?StartAt=50
This call will return information including the name, start date, end date, state, goal, and origin board ID on the sprints currently associated to a Jira Board. This API call can assist with identifying sprints that were created in Jira than shared to the integrated Board, sprints have since been deleted in Jira, and issues with data syncing between Jira and Jira Align. The “?StartAt=50” query parameter will be necessary to investigate all sprints when there are more than 50 sprints on a Jira Board as Jira will only return 50 sprints at a time. This value can be shifted up or down as needed based on the number of sprints on an integrated board.
Tim Keyes
Program Manager
Atlassian
16 accepted answers
1 comment