Powered by Redocly

Token Refresh

Invoke the refresh operation

Action to extend the life of a token. The token's TTL will be extended by a pre-configured duration. A token can only be refreshed up to a limited max-ttl duration, unless it is a periodic token, in which case it can live indefinitely as long as it is refreshed. The token also needs to have the renewable property set to true.

SecurityaccessToken
Request
query Parameters
site
string

Send the request to the specfifed site

Request Body schema:
increment
string <duration>

A duration in years, days, hours, minutes and seconds.

Format is [<digits>y][<digits>d][<digits>m][<digits>s].

Examples: 1y2d5h, 5h or 10m30s

Duration to extend token lifetime with.

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/strongbox/token/refresh
Request samples 
increment: 15m
Response samples 
token: c4d34179-40de-4d21-8961-81f6e0a28ffa
expires-in: 2764227
expires: 2022-01-14T10:24:47.108429Z
accessor: d0596eaa-a798-4062-8688-64fa2818e09b
creation-time: 2022-01-13T10:24:47.108429Z
renewal-time: 2022-01-13T10:24:47.108429Z
➔ Next to Policy