---
title: "Refresh user JWT token"
method: POST
path: "/resources/auth/v1/user/token/refresh"
tags: ["General"]
---

# Refresh user JWT token

`POST /resources/auth/v1/user/token/refresh`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/auth/v1/user/token/refresh`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/auth/v1/user/token/refresh/post.ts> (a function with typed inputs; its response is checked against the schema)

This route refreshes a JWT based on the refresh token expiration time. If the refresh token is valid, the route returns a new JWT and refresh token. Please note that the route expects the refresh cookie of the logged in user as well. Send the **`frontegg-vendor-host`** as a header to declare which vendor. This is your domain name in the Frontegg Portal ➜ Workspace Settings ➜ Domains ➜ Domain Name. Configure your JWT settings in the Frontegg Portal.

## Headers

- `frontegg-vendor-host` string, required

## Request body

- RefreshTokenDto

## Response `201`

- AuthenticationResponseDto
  - `tokenType` string
  - `mfaRequired` boolean, required
  - `mfaToken` string
  - `mfaEnrolled` boolean
  - `mfaDevices` UserMFADevicesResponse
    - `webauthn` UserMFAWebAuthnDeviceResponse[], required
      - `id` string, required
      - `deviceType` 'Platform' | 'CrossPlatform', required
      - `name` string, required
    - `phones` UserMFAPhoneDeviceResponse[], required
      - `id` string, required
      - `phoneNumber` string, required
    - `authenticators` UserMFAAuthenticatorAppResponse[], required
      - `id` string, required
    - `emails` UserMFAEmailCodeResponse[], required
      - `email` string, required
  - `mfaStrategies` object
  - `qrCode` string
  - `recoveryCode` string
  - `accessToken` string, required
  - `refreshToken` string, required
  - `expiresIn` number, required
  - `expires` string, required
  - `userId` string
  - `userEmail` string
  - `emailVerified` boolean
  - `isBreachedPassword` boolean

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)