---
title: "Refresh a user's session using a refresh token retrieved from a previous authentication request."
method: POST
path: "/v1/console/authenticate/refresh"
---

# Refresh a user's session using a refresh token retrieved from a previous authentication request.

`POST /v1/console/authenticate/refresh`

## Request

- Base URL: `http://127.0.0.1:7451`
- URL: `http://127.0.0.1:7451/v1/console/authenticate/refresh`
- Auth: HTTP basic

## Request body

- AuthenticateRefreshRequest: Authenticate against the server with a refresh token.
  - `refresh_token` string: Refresh token.

## Response `200`

A successful response.

- Session: A session.
  - `token` string: Token credential.
  - `refresh_token` string: Refresh token.
  - `mfa_code` string: MFA code required to setup the MFA mechanism.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/heroiclabs/apis/satori-console-api.md) - [All operations](https://skmtc.dev/heroiclabs/apis/satori-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heroiclabs/apis/satori-console-api/revisions/956ff25f811a?raw)
