Jira.Api 9.0.59

Jira.Api nuget package for .NET developers

Contains utilities for interacting with Atlassian JIRA in .NET (C# etc.).

Support Notice

All features tested on JIRA v9.12.2

NEW IN Jira.Api...

If you are migrating from Atlassian.SDK, there are MANY breaking changes, we believe all for the better.

The main items:

• The namespace has changed from Atlassian.SDK to Jira.Api.
• .NET 9.0+ only. What is this, 2024?
• EVERYTHING is asynchronous now, no more sync methods hiding async under the covers.
• Methods still have the same names, but they are now all suffixed with Async e.g. UpdateIssueAsync().
• You MUST provide cancellation tokens to all async methods.
• There are no more optional parameters, all parameters are required.
• The order of skip and take parameters has been changed for everyone's sanity.
  • The new order is skip, take instead of take, skip.
  • This is a nasty one if you are already specifying these value.
• Attachment uploads use FileInfo instead of full path file names.
• The later versions of RestSharp use (for example) Method.Post instead of Method.POST, so you will need to update your code if you are using RestSharp directly.

Don't like these changes? Here are your options:

• Use the old SDK, it is still available as Atlassian.SDK.
• Ask Atlassian to make an "official" nuget that meets your requirements.
• Submit your Pull Requests, we are happy to consider them.
• Fork off ... this project and make your own changes.

Caveats - this project is still very new. We may make further breaking changes in the future, but we will try to avoid them.

Download

• Get the latest via NuGet.

License

This project is licensed under BSD.

Dependencies & Requirements

• RestSharp
• Newtonsoft.Json
• Tested with JIRA v9.12.2
  • We can't move to Jira Cloud, so we use our now-unsupported server version.
  • Happy to receive a complementary 25-user Datacenter license for our troubles, Atlassian?

History

• 2025 - we needed Personal Access Tokens (PATs) support, so we forked and modernized the project. As we progressed, we found many other improvements that we wanted to make, so we made them, even at the expense of breaking changes.

• For a description changes, check out the Change History Page.

• Federico's project began in 2010 during a ShipIt day at Atlassian with provider to query Jira issues using LINQ syntax. Over time it grew to add many more operations on top of the JIRA SOAP API. Support of REST API was added on v4.0 and support of SOAP API was dropped on v8.0.

Related Projects

• Atlassian.NET.SDK - Federico Silva Armas's project that we forked from (no longer maintained)