---
title: "Refresh a session JWT before expiry with a fresh TTL."
method: POST
path: "/v1/auth/refresh"
tags: ["gateway.openapi_Gateway"]
---

# Refresh a session JWT before expiry with a fresh TTL.

`POST /v1/auth/refresh`

## Request

- Base URL: `https://api.fireworks.ai`
- URL: `https://api.fireworks.ai/v1/auth/refresh`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/docs/v1/auth/refresh/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- GatewayRefreshSessionTokenRequest: Request to refresh an existing session JWT before it expires.
  - `refreshToken` string: The refresh token used to mint a fresh access token.

## Response `200`

A successful response.

- GatewayRefreshSessionTokenResponse: Response containing the refreshed session JWT.
  - `token` string: New signed JWT with fresh TTL and the same session claims.
  - `expireTime` string, date-time: When the new token expires.
  - `refreshToken` string: Refresh token for subsequent refreshes. In V1 this may be unchanged; later versions may rotate it.
  - `refreshExpireTime` string, date-time: When the refresh token expires.

## Changes

- **2026-10-16** `3bf245180173`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/auth/refresh/post.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/3bf245180173?raw)