Refresh access token

POST

/v1/auth/refresh

Maintainer:Not configured

Exchange a valid refresh token for a new access/refresh token pair. The previous token pair is immediately revoked. Refresh tokens expire after 7 days.

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

Example

{
    "refresh_token": "jL2nO5pQ8rS1tU4vW7xZ0aB3cD6eF9gH"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200

application/json

New token pair issued

Bodyapplication/json

Example

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

🟠401Unauthorized

🟠422ValidationError

Modified at 2026-04-24 12:59:02

Obtain access token

Get token info