v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB

Sessions

Refresh a session

Refreshes a session by creating a new session token. A 401 is returned when there are validation errors, which signals the SDKs to fall back to the handshake flow.

post/sessions/{session_id}/refresh

Path parameters

session_idstring required

The ID of the session

Request body

expired_tokenstring required

The JWT that is sent via the __session cookie from your frontend. Note: this JWT must be associated with the supplied session ID.

refresh_tokenstring required

The refresh token from the __refresh cookie set via FAPI's handshake flow.

request_originstring required

The origin of the request.

request_headersobject nullable

The headers of the request.

format'token' | 'cookie' nullable

The format of the response.

request_originating_ipstring nullable

The IP address of the request.

Response

Success