How to reindex Jira using REST API via cURL command
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the server and data center platforms.
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'
When type is not specified, the default value will be BACKGROUND_PREFERRED
For all of the following procedures, you must use an account with the Jira Administrators global permission.
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