Refresh an access token

POST

/auth/refresh

Authentication

Last modified:2026-06-03 19:01:51

Maintainer:Not configured

Exchange a valid refresh token for a new access token and refresh token pair. The previous tokens are revoked immediately.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

New token pair issued.

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/auth/refresh' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "refresh_token": "eyJ0eXBlIjoicmVmcmVzaCIsImlkIjoxfQ..."
}'

Response Example

200 - Example 1

{
    "token_type": "Bearer",
    "access_token": "string",
    "refresh_token": "string",
    "expires_in": 3600,
    "refresh_expires_in": 604800
}

Modified at 2026-06-03 19:01:51

Exchange credentials for a token pair

Inspect the current token