JIRA api /rest/api/2 depreciated. Needs path updated

[rdsim8589]

Bug summary

I got this error message when trying to access the JIRA end point

response text = {"errorMessages":["The requested API has been removed. Please migrate to the /rest/api/3/search/jql API. A full migration guideline is available at https://developer.atlassian.com/changelog/#CHANGE-2046"],"errors":{}}

What is changing?

We’re deprecating the following Jira Platform REST endpoints:

GET /rest/api/2|3|latest/search - Search for issues using JQL (GET)

POST /rest/api/2|3|latest/search - Search for issues using JQL (POST)

POST /rest/api/2|3|latest/search/id - Search issue IDs using JQL

POST /rest/api/2|3|latest/expression/eval - Evaluate Jira expression

There is a deprecation period of 6 months, and these endpoints will be removed after May 1, 2025.

Is there an existing issue for this?

• I have searched the existing issues

Jira Instance type

Jira Cloud (Hosted by Atlassian)

Jira instance version

No response

jira-python version

main, 3.10.5

Python Interpreter version

3.12

Which operating systems have you used?

• Linux
• macOS
• Windows

Reproduction steps

# 1. using the `search_issues` method of the JIRA client.py file. The trace stack was triggered.

Stack trace

File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/jira/client.py", line 3557, in search_issues
    issues = self._fetch_pages(
             ^^^^^^^^^^^^^^^^^^
  File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/jira/client.py", line 817, in _fetch_pages
    resource = self._get_json(
               ^^^^^^^^^^^^^^^
  File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/jira/client.py", line 4358, in _get_json
    else self._session.get(url, params=params)
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/requests/sessions.py", line 602, in get
    return self.request("GET", url, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/jira/resilientsession.py", line 247, in request
    elif raise_on_error(response, **processed_kwargs):
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/rsim/.local/share/virtualenvs/new_srampy-n6qhSQiD/lib/python3.12/site-packages/jira/resilientsession.py", line 72, in raise_on_error

raise JIRAError(
jira.exceptions.JIRAError: JiraError HTTP 410 url:  <url>/rest/api/2/search?jql=%22Dashboard+Pattern%22+is+not+EMPTY+and+%28resolved+is+EMPTY+or+resolved+%3E+-365d%29&startAt=0&validateQuery=True&fields=%2Aall&maxResults=100
	text: The requested API has been removed. Please migrate to the /rest/api/3/search/jql API. A full migration guideline is available at https://developer.atlassian.com/changelog/#CHANGE-2046

Expected behaviour

expected json with searched for jira issues.

Additional Context

No response

[lexipimenidis]

Same bug here.

[chrisjwhiteley]

The new function was introduced in v3.10.0.
Details here: #2326

[Jeevi1990]

Hi ,
I woudl like to contribute to the same . Can someone guide me to start with this ?

[waffletchnlgy]

I am using JIRA package version: 3.10.5 to leverage the new enhanced_search_issues() and /rest/api/3.
However, I notice that calls are still made to /rest/api/2/search/jql.

DEBUG:urllib3.connectionpool:https://1rti.atlassian.net:443 "GET /rest/api/2/search/jql?jql=project+%3D+CORE+AND+issueType+%3D+Bug+AND+createdDate+%3E%3D+%27-7d%27&fields=%2Aall&maxResults=50 HTTP/1.1" 200 None

Is this possibly an issue in JIRA package or is this an issue with permissions in our Jira (Cloud) instance?