Refresh authentication token

edit

Issues a new authentication token.

Request

edit

POST /api/v1/users/auth/_refresh

Responses

edit
200

(TokenResponse) The token refreshed successfully and was returned in the body of the response.

401

(BasicFailedReply) The authentication token is invalid or expired. (code: root.unauthorized)

Headers

x-cloud-error-codes (string; allowed values: [root.unauthorized])
The error codes associated with the response
501

(BasicFailedReply) The administrator needs to configure the authentication cluster. (code: authc.no_authentication_cluster)

Headers

x-cloud-error-codes (string; allowed values: [authc.no_authentication_cluster])
The error codes associated with the response
502

(BasicFailedReply) The authentication cluster failed to process the request. The response body contains details about the error. (code: authc.authentication_cluster_error)

Headers

x-cloud-error-codes (string; allowed values: [authc.authentication_cluster_error])
The error codes associated with the response

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

edit
curl -XPOST https://{{hostname}}/api/v1/users/auth/_refresh \
-H "Authorization: ApiKey $ECE_API_KEY"