External: Token

Refresh Token

Changed on

Exchange refresh token for new access token.

This endpoint accepts both SDK and Developer refresh tokens and returns a new access token of the same type. Implements refresh token rotation: the old refresh token is revoked and a new one is issued.

Args: payload: Request containing the refresh token db: Database session

Returns: TokenResponse with new access token and new refresh token

Raises: 401: If the refresh token is invalid or revoked

post/api/v1/token/refresh

Request

  • Base URL: https://api.openwearables.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.openwearables.io/api/v1/token/refresh
  • Auth: none declared

Request body

refresh_tokenstring required

Response

Successful Response

access_tokenstring required
token_typestring
refresh_tokenstring nullable
expires_ininteger nullable
password_change'required' | 'recommended'

How the portal should ask a developer who signed in with the default password to change it.

Changes