Navigating Atlassian’s REST API: Insights for Stability and Efficiency

In that article you can find lessons from Interacting with Atlassian Products via REST API.


In the dynamic landscape of software integration, Atlassian products have carved a niche for themselves. Whether it’s Jira’s meticulous issue tracking or Confluence’s collaborative prowess, the power of these tools becomes even more potent when harnessed through REST APIs. However, it’s not all smooth sailing. As I embarked on a journey of interacting with Atlassian products via REST API, I uncovered a series of insights that extend beyond the surface, enabling better stability, efficiency, and a smoother experience for both developers and users.

1. Purposeful Integration: Aiming for Stability

Automated integrations and scripts can be a blessing or a curse. While they enhance productivity, they can also strain system stability. Sending huge batches of requests to Jira without discretion can lead to performance drops and even downtime. To mitigate this, it’s crucial to define the purpose and frequency of interactions. Instead of brute-forcing the system with excessive requests, strive for a balance that serves your needs without compromising the platform’s stability.

2. Session Management: The Art of Conservation

Creating a new session might seem like standard procedure, but in reality, it can be an expensive process, especially when third-party systems like LDAP are involved. Instead of spawning new sessions unnecessarily, focus on session management. Reusing existing sessions whenever possible reduces the overhead of repeated authentication, contributing to smoother interactions and preserving system resources.

3. Pagination: The Chunk Strategy

When dealing with large datasets, pagination becomes your ally. Rather than overwhelming the system with hefty requests, break down your queries into smaller, manageable chunks. This approach not only reduces the chances of triggering rate limits but also prevents memory consumption. By dealing with manageable chunks, you can minimize the need for retry requests and ensure a more efficient interaction process.

4. Scoped Queries: Focusing on What Matters

“Scope” is the watchword here. Instead of fetching all-encompassing data, employ JQL (Jira Query Language) or CQL (Confluence Query Language) queries to retrieve precisely what you need. Whether it’s fetching modified data or specific information, scoping your queries minimizes the strain on the system and optimizes your interactions.

5. Field and Object Definition: Clarity is Key

When fetching data from Jira tickets, clarity is your ally. Define in advance which fields or properties you need from the tickets. This not only streamlines your queries but also prevents unnecessary data retrieval, contributing to a more efficient and focused interaction process.

6. Personal Access Tokens: A Friend in Need

Authentication can be a double-edged sword. To make the process smoother and more secure, opt for personal access tokens. These tokens serve as a bridge between security and ease, allowing for seamless interactions while ensuring your system’s safety.

7. The Rate Limiting Conundrum: Handling Concurrency

Concurrency can be a tricky beast to tame, especially in systems with rate limiting mechanisms. When these limits are breached, your service account might face temporary blocks. To avoid this, employ strategies like the one offered by the atlassian-python-api wrapper you mentioned. This wrapper simplifies concurrency management, helping you navigate rate limits and preventing service interruptions.


Interacting with Atlassian products through REST APIs unlocks a realm of possibilities, but it’s not without its challenges. From session management to scoping queries, each aspect of interaction impacts system stability and efficiency. By adhering to these recommendations, and leveraging tools like the atlassian-python-api wrapper, you’re not just interacting with Atlassian products — you’re optimizing your entire development process, creating a win-win situation for both your applications and the users they serve.


Kristján Geir Mathiesen
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
September 1, 2023

Wow! Thank you, @Gonchik Tsymzhitov for this article!

Like Gonchik Tsymzhitov likes this
Gonchik Tsymzhitov
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
September 3, 2023

@Kristján Geir Mathiesen  Thank you!  Each point includes stories about long debugs and troubleshoting


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events