Refresh session

If your access tokens expire, this API endpoint takes a Refresh Token and returns a new set of Access Tokens for your session. Note that we don't rotate the Refresh Token itself, and it's not returned by this API endpoint.

post/session/refresh

Request

Base URL
https://api.tower.dev/v1
Auth
- HTTP bearer
- or API key in header X-API-Key
TypeScript
https://skmtc.dev/tower/apis/tower-api/docs/session/refresh/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

refresh_tokenstring

The refresh token associated with the session to refresh.

Example request

{
  "$schema": "https://api.tower.dev/v1/schemas/RefreshSessionParams.json"
}

Response

$schemastring uri

A URL to the JSON Schema for this object.

refreshed_atstring date-time required

A timestamp that indicates the last time the session data was refreshed.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/RefreshSessionResponse.json"
}

Changes

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