Skip to content
URL:
https://<root>/system/indexer/reindex
Methods:
POST
Version Introduced:
10.2.1

Access requirements

Required privileges

The Portal Administrator API requires privilege-based access. An administrator must be assigned a specific user privilege, or role, to access any given endpoint. Listed below are the user privileges or roles an administrator can be assigned that provides access to this endpoint. If multiple privileges are listed, only one needs to be assigned to gain access.


Tokens

This API requires token-based authentication. A token is automatically generated for administrators who sign in to the Portal Administrator API directory's HTML interface. Tokens generated in this way are stored for the entirety of the session.

Those accessing the API directory outside of the HTML interface will need to acquire a session token from the generateToken operation in the Portal Directory API. For security reasons, all POST requests made to the Portal Administrator API must include a token in the request body.


Learn how to generate a token

Description

The reindex operation generates or updates the indexes for content, such as the users, groups, and items stored in the database store. You are required to use this operation to update indexes when upgrading from earlier version of Portal for ArcGIS.

Request parameters

ParameterDetails

mode

The mode in which the indexer should run.

Values: USER_MODE | GROUP_MODE | SEARCH_MODE | FULL_MODE

includes

(Optional)

A comma separated list of elements to include in the index, such as specific items or user accounts.

async

Introduced at 11.5. This parameter specifies whether the operation will run synchronously or asynchronously. If false, the operation is run synchronously. If true, the operation is run asynchronously and the status of the reindex can be checked using the Status resource. The default value is false.

Values: true | false

f

The response format. The default value is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the reindex operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /<context>/portaladmin/system/indexer/reindex HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

mode=FULL_MODE&includes=&async=true&f=json

JSON Response example

The following response is returned when reindexing is complete when async is false.

Use dark colors for code blocksCopy
1
{"status": "success"}

If async is true, the following response is returned.

Use dark colors for code blocksCopy
1
2
3
4
{
  "status": "success",
  "message": "A reindex operation is in progress. Portal content and search operations will be unavailable until the reindex is complete. You can monitor the status by refreshing the Status page."
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.