auth

Renew a session

Changed on Oct 28, 2026

Exchange a refresh token for a new access token and the next refresh token: each refresh token is used once. A native or server client sends refresh_token in the body; a browser presents the __Host-sv_refresh cookie. A full session answers with the member and the account as they stand now.

post/auth/refresh

Request

Base URL
https://api.sparkvault.com/v1
Auth
none required
TypeScript
https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/auth/refresh/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

refresh_tokenstring

Response

The renewed session.

Changes

Oct 28, 2026a9a10e328ba5 Revision changes
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Oct 28, 202656d7c265a77a Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status

Operation history (6 revisions)

Renew a session

Request

Request body

Response 200OK

Changes

Response