Refresh JWT requests
| Method | Path | Description |
|---|---|---|
| POST | /v1/users/refresh_jwt | Get a new authentication token |
Get a new authentication token
POST /v1/users/refresh_jwt
Generate a new JSON Web Token (JWT) for authentication.
Takes a valid token and returns the new token generated by the request.
Request
Example HTTP request
POST /users/refresh_jwt
Request headers
| Key | Value | Description |
|---|---|---|
| Host | cnm.cluster.fqdn | Domain name |
| Authorization | JWT eyJ5bGciOiKIUzI1NiIsInR5cCI6IkpXVCJ9. eyJpYXViOjE0NjU0NzU0ODYsInVpZFI1IjEiLCJ leHAiOjE0NjU0Nz30OTZ9.2xYXumd1rDoE0e dFzcLElMOHsshaqQk2HUNgdsUKxMU | Valid JSON Web Token (JWT) |
Request body
| Field | Type | Description |
|---|---|---|
| ttl | integer | Time to live - The amount of time in seconds the token will be valid (optional) |
Response
Returns a JSON object that contains the generated access token.
Example JSON body
{
"access_token": "eyJ5bGciOiKIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXViOjE0NjU0NzU0ODYsInVpZFI1IjEiLCJleHAiOjE0NjU0Nz30OTZ9.2xYXumd1rDoE0edFzcLElMOHsshaqQk2HUNgdsUKxMU"
}
Status codes
| Code | Description |
|---|---|
| 200 OK | A new token is given. |
| 401 Unauthorized | The token is invalid or password has expired. |