v68

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0144101120.9 KB
Authentication

Rotate token

Rotates the secret value inside the Indexing API token and returns the new raw secret. All other properties of the token are unchanged. In order to rotate the secret value, include the token as the bearer token in the /rotatetoken request. Please refer to Token rotation documentation for more information.

post/api/index/v1/rotatetoken

Response

OK

rawSecretstring

New raw secret

createdAtinteger

Unix timestamp in seconds when the new secret value is assigned to the token. The token needs to be rotated before rotationPeriodMinutes past the createdAt timestamp otherwise it would be rendered unusable.

rotationPeriodMinutesinteger

Refers to the time period in minutes before which this token needs to be rotated. It is required to rotate the token within the specified rotationPeriodMinutes after each /rotatetoken call, otherwise the tokens would expire. Note that the token would still expire at expiresAt timestamp provided during token creation even if the token is being regularly rotated. rotationPeriodMinutes property is inherited from the parent token being rotated