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

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/sessions/{session_id}/refresh
  • Auth: HTTP bearer

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

OR

Changes

No recorded changes to this operation across all 49 revisions of this API.