[Bug][Jira] V2 API removed

[tony-stark-eth]

Search before asking

• I had searched in the issues and found no similar issues.

What happened

Error: The requested API has been removed. Please migrate to the API /rest/api/3/search/jql. A complete migration guide is available at https://developer.atlassian.com/changelog/#CHANGE-2046.

Stack Trace:

attached stack trace -- stack trace: | github.com/apache/incubator-devlake/server/services.runPipeline | /app/server/services/pipeline_runner.go:79 | [...repeated from below...] Wraps: (2) Error running pipeline 20. Wraps: (3) attached stack trace -- stack trace: | github.com/apache/incubator-devlake/server/services.RunTasksStandalone | /app/server/services/task.go:217 | github.com/apache/incubator-devlake/server/services.(*pipelineRunner).runPipelineStandalone.func1 | /app/server/services/pipeline_runner.go:42 | github.com/apache/incubator-devlake/core/runner.runPipelineTasks | /app/core/runner/run_pipeline.go:90 | github.com/apache/incubator-devlake/core/runner.RunPipeline | /app/core/runner/run_pipeline.go:54 | github.com/apache/incubator-devlake/server/services.(*pipelineRunner).runPipelineStandalone | /app/server/services/pipeline_runner.go:38 | github.com/apache/incubator-devlake/server/services.runPipeline | /app/server/services/pipeline_runner.go:76 | github.com/apache/incubator-devlake/server/services.RunPipelineInQueue.func1 | /app/server/services/pipeline.go:360 | runtime.goexit | /usr/local/go/src/runtime/asm_amd64.s:1598 Wraps: (4) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/server/services.RunTasksStandalone.func1 | | /app/server/services/task.go:189 | Wraps: (2) Error running task 176. | Wraps: (3) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/core/runner.RunPluginSubTasks | | /app/core/runner/run_task.go:333 | | [...repeated from below...] | Wraps: (4) subtask collectEpics ended unexpectedly | Wraps: (5) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*WorkerScheduler).WaitAsync | | /app/helpers/pluginhelper/api/worker_scheduler.go:173 | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*ApiCollector).Execute | | /app/helpers/pluginhelper/api/api_collector.go:206 | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*StatefulApiCollector).Execute | | /app/helpers/pluginhelper/api/api_collector_stateful.go:97 | | github.com/apache/incubator-devlake/plugins/jira/tasks.CollectEpics | | /app/plugins/jira/tasks/epic_collector.go:126 | | github.com/apache/incubator-devlake/core/runner.runSubtask | | /app/core/runner/run_task.go:425 | | github.com/apache/incubator-devlake/core/runner.RunPluginSubTasks | | /app/core/runner/run_task.go:330 | | github.com/apache/incubator-devlake/core/runner.RunPluginTask | | /app/core/runner/run_task.go:165 | | github.com/apache/incubator-devlake/core/runner.RunTask | | /app/core/runner/run_task.go:139 | | github.com/apache/incubator-devlake/server/services.runTaskStandalone | | /app/server/services/task_runner.go:114 | | github.com/apache/incubator-devlake/server/services.RunTasksStandalone.func1 | | /app/server/services/task.go:187 | | runtime.goexit | | /usr/local/go/src/runtime/asm_amd64.s:1598 | Wraps: (6) Retry exceeded 3 times calling api/2/search. The last error was: Http DoAsync error calling [method:GET path:api/2/search query:map[expand:[changelog] jql:[issue in () and updated >= '2025/09/02 02:00' ORDER BY created ASC] maxResults:[100] startAt:[0]]]. Response: {"errorMessages":["Die angeforderte API wurde entfernt. Migrieren Sie bitte zur API /rest/api/3/search/jql. Eine vollständige Migrationsrichtlinie ist unter https://developer.atlassian.com/changelog/#CHANGE-2046 verfügbar."],"errors":{}} (410) | Error types: (1) *withstack.withStack (2) *errutil.withPrefix (3) *withstack.withStack (4) *errutil.withPrefix (5) *withstack.withStack (6) *errutil.leafError Error types: (1) *withstack.withStack (2) *errutil.withPrefix (3) *withstack.withStack (4) *errutil.leafError

What do you expect to happen

Please migrate to the JIRA V3 API so I can continue using Devlake :)

How to reproduce

Latest images with a fresh JIRA Instance should result in this error.

Anything else

No response

Version

v1.0.2@41c047d

Are you willing to submit PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct

[dosubot]

Hi @tony-stark-eth! I'm Dosu and I’m helping the incubator-devlake team.

The Jira V2 API endpoint (/api/2/search) has been removed by Atlassian, which breaks DevLake's Jira integration when collecting epics and other issue data. The error you’re seeing is caused by hardcoded usage of this deprecated endpoint in the Jira plugin, specifically in epic_collector.go. DevLake currently does not support the Jira V3 API (/rest/api/3/search/jql), and there is no evidence of ongoing migration work or official guidance in the repository or documentation.

To restore Jira integration, the codebase needs to update all references to the V2 endpoint and migrate to the V3 API, following Atlassian’s migration guide. Until this migration is completed, Jira data collection in DevLake will not work with new Jira instances. There are no documented workarounds or patches available at this time. If you or others are interested in contributing, the migration would involve updating the URL templates and query logic in the Jira plugin collectors to use the V3 endpoints.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[davinogueiradev]

@tony-stark-eth the PR #8559 solved this bug

[tony-stark-eth]

@tony-stark-eth the PR #8559 solved this bug

Any idea when new docker images are built?

[klesh]

@tony-stark-eth @d4x1 will release a new beta this week.

[d4x1]

@tony-stark-eth @d4x1 will release a new beta this week.

v1.0.3-beta5 is released. You can find the latest releases: here: https://github.com/apache/incubator-devlake/releases

[tony-stark-eth]

I'll be able to test it in two weeks, then I can give feedback. Or just close it and I'll reopen it if necessary :)

[klesh]

No rush. Take you time to test then close the issue afterward.

[dsiebel]

Running v1.0.3-beta6 and the issue seems to be resolved.
No more errors on the Jira step.

[klesh]

Running v1.0.3-beta6 and the issue seems to be resolved. No more errors on the Jira step.

Thanks for the information. Closing the issue.

[v1bh0r]

@klesh I'm able to reproduce the issue on the main branch HEAD - 17837c0.

attached stack trace -- stack trace: | github.com/apache/incubator-devlake/server/services.runPipeline | /app/server/services/pipeline_runner.go:79 | [...repeated from below...] Wraps: (2) Error running pipeline 45. Wraps: (3) attached stack trace -- stack trace: | github.com/apache/incubator-devlake/server/services.RunTasksStandalone | /app/server/services/task.go:217 | github.com/apache/incubator-devlake/server/services.(*pipelineRunner).runPipelineStandalone.func1 | /app/server/services/pipeline_runner.go:42 | github.com/apache/incubator-devlake/core/runner.runPipelineTasks | /app/core/runner/run_pipeline.go:90 | github.com/apache/incubator-devlake/core/runner.RunPipeline | /app/core/runner/run_pipeline.go:54 | github.com/apache/incubator-devlake/server/services.(*pipelineRunner).runPipelineStandalone | /app/server/services/pipeline_runner.go:38 | github.com/apache/incubator-devlake/server/services.runPipeline | /app/server/services/pipeline_runner.go:76 | github.com/apache/incubator-devlake/server/services.RunPipelineInQueue.func1 | /app/server/services/pipeline.go:360 | runtime.goexit | /usr/local/go/src/runtime/asm_arm64.s:1172 Wraps: (4) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/server/services.RunTasksStandalone.func1 | | /app/server/services/task.go:189 | Wraps: (2) Error running task 640. | Wraps: (3) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/core/runner.RunPluginSubTasks | | /app/core/runner/run_task.go:333 | | [...repeated from below...] | Wraps: (4) subtask collectEpics ended unexpectedly | Wraps: (5) attached stack trace | -- stack trace: | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*WorkerScheduler).WaitAsync | | /app/helpers/pluginhelper/api/worker_scheduler.go:173 | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*ApiCollector).Execute | | /app/helpers/pluginhelper/api/api_collector.go:206 | | github.com/apache/incubator-devlake/helpers/pluginhelper/api.(*StatefulApiCollector).Execute | | /app/helpers/pluginhelper/api/api_collector_stateful.go:97 | | github.com/apache/incubator-devlake/plugins/jira/tasks.CollectEpics | | /app/plugins/jira/tasks/epic_collector.go:126 | | github.com/apache/incubator-devlake/core/runner.runSubtask | | /app/core/runner/run_task.go:425 | | github.com/apache/incubator-devlake/core/runner.RunPluginSubTasks | | /app/core/runner/run_task.go:330 | | github.com/apache/incubator-devlake/core/runner.RunPluginTask | | /app/core/runner/run_task.go:165 | | github.com/apache/incubator-devlake/core/runner.RunTask | | /app/core/runner/run_task.go:139 | | github.com/apache/incubator-devlake/server/services.runTaskStandalone | | /app/server/services/task_runner.go:114 | | github.com/apache/incubator-devlake/server/services.RunTasksStandalone.func1 | | /app/server/services/task.go:187 | | runtime.goexit | | /usr/local/go/src/runtime/asm_arm64.s:1172 | Wraps: (6) Retry exceeded 3 times calling api/2/search. The last error was: Http DoAsync error calling [method:GET path:api/2/search query:map[expand:[changelog] jql:[issue in (C360-127,C360-126,C360-124,C360-1606,C360-129,C360-718,C360-135,C360-3152,C360-2732,C360-3990,C360-4693,C360-6891,C360-680,C360-13378,C360-16656,C360-17307,C360-4560,C360-25086,C360-23304,C360-722,C360-19380,C360-29081,C360-30243,C360-31610) and updated >= '2025/04/07 05:30' ORDER BY created ASC] maxResults:[100] startAt:[0]]]. Response: {"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":{}} (410) | Error types: (1) *withstack.withStack (2) *errutil.withPrefix (3) *withstack.withStack (4) *errutil.withPrefix (5) *withstack.withStack (6) *errutil.leafError Error types: (1) *withstack.withStack (2) *errutil.withPrefix (3) *withstack.withStack (4) *errutil.leafError

• Jira Cloud instance (e.g., https://company.atlassian.net)
• DevLake running on commit 17837c0 (latest main branch as of Oct 7, 2025)
• Affected Task: collectEpics (and potentially other collectors)

   curl -s "https://company.atlassian.net/rest/api/2/serverInfo" | jq '.deploymentType'
   # Output: "Cloud"

Code Contains Fix (from PR #8547):
The file backend/plugins/jira/tasks/epic_collector.go (lines 86-92) contains logic to check deployment type:

// Choose API endpoint based on JIRA deployment type
if data.JiraServerInfo.DeploymentType == models.DeploymentServer {
    logger.Info("Using api/2/search for JIRA Server")
    err = setupApiV2Collector(apiCollector, data, epicIterator, jql)
} else {
    logger.Info("Using api/3/search/jql for JIRA Cloud")
    err = setupApiV3Collector(apiCollector, data, epicIterator, jql)
}