Regarding Version v2 changelog #CHANGE-2046

[AppFlow]

Hi All,

We are aware that the Jira API version v2 is planned to sunset progressively ( https://developer.atlassian.com/changelog/#CHANGE-2046) and it is requested to migrate to V3 search API JQL, However we have observed that version v2 also supports Search JQL So will the search JQL for v2 also deprecated and sunset ?

Can customer use the existing v2 version with just enabling the search JQL ? Will Jira cloud  Support   v2 with JQL ?

[Chitra Nagdeo · Accepted solution]

Hello @AppFlow Team,

Welcome to Atlassian community!

Please note as part of the v2 API deprecation, all endpoints—including those supporting Search JQL—are planned to be deprecated and eventually sunset. This means that the ability to use JQL via the v2 /search endpoint will also be removed in line with the overall v2 API retirement.

My Recommendations:

• Begin migrating all API calls to v3 endpoints, especially for search and JQL operations.

• Monitor the Atlassian developer changelog for updates on deprecation timelines.

• Test your integrations with v3 to ensure compatibility and take advantage of new features and improvements.

I hope this was helpful!

Have a good day!

Regards
Chitra Nagdeo

[Sunny Ape]

Hello @Chitra Nagdeo 

Atlassian have been telling everyone that they are "planning to deprecate and eventually sunset" the whole V2 API sometime in the future for as long as I can remember.

Do you personally have an actual, specific, exact date to share when the retirement of the entire V2 API will take place? In your statement below, you inferred the retirement of the entire V2 API (every single V2 endpoint) will occur.... NEXT MONTH!!!

[Chitra Nagdeo]

Hey @Sunny Ape ,

I am specifically listing below API's which are deprecating

GET /rest/api/3/search --> GET /rest/api/3/search/jql

POST /rest/api/3/search --> POST /rest/api/3/search/jql

POST /rest/api/3/search/id --> POST /rest/api/3/search/jql

POST /rest/api/3/expression/eval --> POST /rest/api/3/expression/evaluate

Regards
Chitra Nagdeo

[Sunny Ape]

You need to choose your terminology more carefully. Those things you have listed are being deprecated are NOT APIs, they are ENDPOINTS.

As per the change notice:

Sorry, but there is a very significant difference between telling people that some API endpoints are being deprecated and 'an' API is being deprecated and 'all endpoints' are being deprecated..

[Chitra Nagdeo]

I agree with @Sunny Ape 

We are changing/Deprecating the endpoints as stated in article and Atlassian developer changelog

@AppFlow , I hope the information you were looking for is clear and only below endpoints needs modification

GET /rest/api/3/search --> GET /rest/api/3/search/jql

POST /rest/api/3/search --> POST /rest/api/3/search/jql

POST /rest/api/3/search/id --> POST /rest/api/3/search/jql

POST /rest/api/3/expression/eval --> POST /rest/api/3/expression/evaluate

[AppFlow · Accepted solution]

Thank you Chitra for response

[AppFlow]

Thank you for response

[AppFlow]

Hi Chitra

By when the API v2 is going to sunset any plan date for complete v2 API retirement

Thank you

[Chitra Nagdeo]

Hey @AppFlow ,

Refer below details

Jira Cloud REST API v2 Deprecation Timeline

• 2024-10-31: Atlassian announced the deprecation of v2 and published the migration guide (Atlassian developer changelog).

• 2025-05-01: Deprecation period ends. v2 is no longer supported for new development.

• 2025-05-05 to 2025-07-31: Atlassian rolls out a hybrid solution, Old endpoints still work but may have eventual consistency and performance changes.

• 2025-08-01 to 2025-10-31: Full shutdown phase. Atlassian will progressively disable v2 endpoints for all customers. By October 31, 2025, v2 endpoints will be fully retired and stop responding.

I hope this helps!

Regards
Chitra Nagdeo

[Sunny Ape]

Hello @Chitra Nagdeo 

You need to choose your words more carefully, You have effectively just stated that Atlassian are shutting down / disabling the ENTIRE V2 REST API of Jira Cloud by 31st of October.... this year!!

The change notice says that Atlassian are only shutting down / disabling some V2 REST API endpoints, that's it!