How to reindex Jira using REST API via cURL command

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

This KB describes how to use the REST API to trigger a reindex in Jira. The examples below uses cURL, however you can use the REST client of your choice.


To trigger a Full re-index (Lock Jira and Reindex):

curl -D- \
  -X POST \
  -H "Authorization: Bearer <token>" \
  -H 'Accept: application/json' \
    '$BASEURL/rest/api/2/reindex?type=FOREGROUND'


(info) When type is not specified, the default value will be BACKGROUND_PREFERRED

(info)For all of the following procedures, you must use an account with the Jira Administrators global permission.

(info)For more information on generating Using Personal Access Tokens check the documentation.

Data Center

For Jira Data Center a better approach than background indexing is to take one node out of the cluster and run FOREGROUND reindexing. See  JRASERVER-66969 - Getting issue details... STATUS

When using the Jira Base URL, the request can be routed to any node in your cluster, making that node unavailable until the reindex is finished. To choose a specific node, replace Jira's Base URL with the IP address of that node:

curl -D- \
  -X POST \
  -H "Authorization: Bearer <token>" \
  -H 'Accept: application/json' \
    '$NODEIP/rest/api/2/reindex?type=FOREGROUND'

Notes

Type of re-indexing available:

  • FOREGROUND - runs a lock/full reindexing
  • BACKGROUND - runs a background reindexing. If Jira fails to finish the background reindexing, respond with 409 Conflict (error message).
  • BACKGROUND_PREFERRED  - If possible do a background reindexing. If it's not possible (due to an inconsistent index), do a foreground reindexing.

More information on this REST endpoint can be found in https://docs.atlassian.com/software/jira/docs/api/REST/latest

Last modified on Nov 15, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.