Jira Cloud API breaking behavior changes without contract stability

Question

Hello Atlassian team 👋
I have run into repeated breaking behavior changes in the Jira Cloud API without any obvious contract/versioning signal, and it is causing avoidable failures in our integration.

Most recently, I hit cases where request shapes that worked previously started failing unless fields were sent explicitly as `null` instead of being omitted. This changed runtime behavior in a way that broke our existing client logic even though the integration had been working before.

This kind of change is difficult for integrators because:
- it breaks production workflows unexpectedly
- it is not obvious from the previous API behavior
- it forces emergency client patches for what appears to be a server-side contract shift

What I need from Atlassian:
1. please avoid silent breaking changes in Jira Cloud API request/response behavior 😊
2. if behavior must change, please communicate it clearly and ahead of time
3. please document whether fields must be omitted vs explicitly set to `null`
4. please confirm the expected contract for optional and nullable fields across Jira Cloud endpoints

Concrete example:
- issue comments / issue update flows started behaving differently depending on whether optional fields were omitted or explicitly sent as `null`
- this required code changes on our side for behavior that had previously worked

Please let me know:
- whether this is an intentional API contract change
- where such changes are announced
- what stability guarantees I should rely on for Jira Cloud integration

Thanks 🤗

Michal Jarnot

Michal Jarnot · Answer

JIRA API error (400): We could not find the sprint

OK at this point I have to be doing something wrong. There is no way that the system is this broken. 🤣

Arkadiusz Wroblewski · Answer

@Michal Jarnot

If you want my honest opinion? Yes, sometimes.

A layoff of 1,600 people at once (Specialist which was working deep on Code from Years), shifting that work onto others, and the general push toward “vibe coding” can absolutely have an effect.

And I think some of that has been visible over roughly the last 18 months. To me, that is also part of why Atlassian is now introducing the new seasonal release approach:
https://community.atlassian.com/forums/Jira-Cloud-Admins-articles/Coming-soon-Jira-seasonal-releases/ba-p/3177320

They have faced quite a bit of backlash in recent months because of unexpected changes.

PS: What annoys me most is how huge the ecosystem has become. It is sometimes really difficult to keep up with all the changes, and scrolling through endless release notes is not exactly enjoyable. The platform is developing constantly, so it is easy to miss something important.

Michal Jarnot · Answer

Does that mean that I am correct and Atlassian is unknowingly introducing breaking changes or is there something that I missed?

I only use ~15 endpoints from the enormous API that Atlassian provides but still I had to rewrite one tool yesterday and then another today. I can't imagine what people and companies who rely on Atlassian run into if they use more of the API services.