Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Celebration

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root

Avatar

1 badge earned

Collect

Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!

Challenges
Coins

Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.

Recognition
Ribbon

Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!

Leaderboard

Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,463,207
Community Members
 
Community Events
176
Community Groups

Jira and Jira Align Integration: Jira Rest API Calls for Configuration and Troubleshooting

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. 

 

1 comment

JiraJared Community Leader Jun 09, 2020

Great article @Tim Keyesthanks for sharing! 

Like # people like this

Comment

Log in or Sign up to comment
TAGS

Atlassian Community Events