`api.auth.refresh`

Rotate a refresh token into a new TokenPair. The old refresh token is invalidated server-side. Persists the new pair to the configured tokenStore automatically.

const  = await ..("rt_…");

Argument	Type
`refresh_token`	string

Returns: Promise<TokenPair>.

Throws: ApiError with status: 401 on revoked or expired refresh tokens.

REST endpoint: POST /auth/refresh.