Skip to content

search_issues(): search endpoint deprecated and removed #2367

@tothandor

Description

@tothandor

Bug summary

Since yesterday /rest/api/2|3|latest/search REST API endpoint has been removed, so the seach_issues function no longer works.
See https://developer.atlassian.com/changelog/#CHANGE-2046

The new endpoint is almost identical, with a /jql suffix: /rest/api/3/search/jql

Please update!

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

3.8.0

Python Interpreter version

3.9.19

Which operating systems have you used?

  • Linux
  • macOS
  • Windows

Reproduction steps

# 1. Given a Jira client instance
jira: JIRA
# 2. When I call the function with argument x
jira.search_issues('updated >= -1d')
# 3. You'll get the error seen in the stack trace

Stack trace

Traceback (most recent call last):  File "<stdin>", line 1, in <module>  File "/srv/airflow/venv/lib64/python3.9/site-packages/jira/client.py", line 3557, in search_issues    issues = self._fetch_pages(
  File "/srv/airflow/venv/lib64/python3.9/site-packages/jira/client.py", line 817, in _fetch_pages
    resource = self._get_json(
  File "/srv/airflow/venv/lib64/python3.9/site-packages/jira/client.py", line 4358, in _get_json
    else self._session.get(url, params=params)
  File "/srv/airflow/venv/lib64/python3.9/site-packages/requests/sessions.py", line 602, in get
    return self.request("GET", url, **kwargs)
  File "/srv/airflow/venv/lib64/python3.9/site-packages/jira/resilientsession.py", line 247, in request
    elif raise_on_error(response, **processed_kwargs):
  File "/srv/airflow/venv/lib64/python3.9/site-packages/jira/resilientsession.py", line 72, in raise_on_error
    raise JIRAError(
jira.exceptions.JIRAError: JiraError HTTP 410 url: https://###masked####.atlassian.net/rest/api/2/search?jql=updated+%3E%3D+yesterday&startAt=0&validateQuery=True&fields=%2Aall&maxResults=50
        text: The requested API has been removed. Please use the newer, enhanced search-based API instead. Deprecation details are available at https://developer.atlassian.com/changelog/#CHANGE-2046.

        response headers = {'Content-Type': 'application/json;charset=UTF-8', 'Transfer-Encoding': 'chunked', 'Connection': 'keep-alive', 'Date': 'Thu, 21 Aug 2025 09:13:38 GMT', 'Server': 'AtlassianEdge', 'Timing-Allow-Origin': '*', 'X-Arequestid': '2562c91d76b9df99424991e2bc9b2ef7', 'X-Aaccountid': '5fd8a6c2692b7901103a7638', 'Cache-Control': 'no-cache, no-store, no-transform', 'X-Beta-Ratelimit-Limit': '350', 'X-Beta-Ratelimit-Remaining': '349', 'Beta-Retry-After': '1', 'X-Beta-Ratelimit-Reset': '2025-08-21T09:13Z', 'X-Beta-Ratelimit-Reason': 'jira-burst-based', 'X-Content-Type-Options': 'nosniff', 'X-Xss-Protection': '1; mode=block', 'Atl-Traceid': '3f4e90e6ce3c4463a812f26af01f14d2', 'Atl-Request-Id': '3f4e90e6-ce3c-4463-a812-f26af01f14d2', 'Strict-Transport-Security': 'max-age=63072000; includeSubDomains; preload', 'Report-To': '{"endpoints": [{"url": "https://dz8aopenkvv6s.cloudfront.net"}], "group": "endpoint-1", "include_subdomains": true, "max_age": 600}', 'Nel': '{"failure_fraction": 0.001, "include_subdomains": true, "max_age": 600, "report_to": "endpoint-1"}', 'Server-Timing': 'atl-edge;dur=67,atl-edge-internal;dur=15,atl-edge-upstream;dur=52,atl-edge-pop;desc="aws-eu-central-1"', 'X-Cache': 'Error from cloudfront', 'Via': '1.1
7c5a62c7d17ef0da2fddb0ebbf1f140a.cloudfront.net (CloudFront)', 'X-Amz-Cf-Pop': 'BUD50-P2', 'X-Amz-Cf-Id': 'iXu7N-x_Cj6s1XSu96FqFR82hMQYHKINHcD2LMgh2Gg0bguWmcSgtA=='}
        response text = {"errorMessages":["The requested API has been removed. Please use the newer, enhanced search-based API instead. Deprecation details are available at https://developer.atlassian.com/changelog/#CHANGE-2046."],"errors":{}}

Expected behaviour

No errors! :)

Additional Context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions