---
title: "Refresh the Access Token"
method: POST
path: "/v1/login/oauth/refresh_token"
tags: ["Authentication API"]
---

# Refresh the Access Token

`POST /v1/login/oauth/refresh_token`

Use this endpoint to renew an expired access token with a valid refresh token.

## Request body

- RefreshTokenInput — Information used to exchange a refresh token for an access token.
  - `refreshToken` string, required — The refresh token that you want to exchange.
  - `scope` string, required — The access level for the new token.

## Response `200`

Indicates that the resource was successfully created and the operation was completed as expected.

- OAuth2Token — Information used to manage OAuth2 authentication data. It securely stores access credentials, ensuring seamless authorization and control over protected resources.
  - `accessToken` string, required — A temporary token that grants the user secure access the APIs.
  - `expiresIn` integer, required — The time (in seconds) until the token expires.
  - `idToken` string — The identity details about the authenticated user in OpenID Connect standards. It can be used to verify user authentication.
  - `refreshToken` string, required — A long-lived token that allows users to obtain a new `access_token` without requiring them to log in again.
  - `scope` string — The level of access granted to the issued tokens
  - `tokenType` string, required — The type of token issued.

## Other responses

- `400`
- `401`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)