External: Mobile SDK

Redeem Invitation Code

Changed on

Redeem a single-use invitation code for SDK tokens.

Public endpoint (no authentication required). Exchanges a valid, non-expired, single-use invitation code for access_token, refresh_token, and user_id. The returned token is write-only to the /sdk/* endpoints.

This backs the standalone onboarding flow used by the Open Wearables app and the SDK example apps. It is not the standard integration path - if your app has its own backend, mint and forward a token with POST /api/v1/users/{user_id}/token instead of redeeming codes on the client.

post/api/v1/invitation-code/redeem

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/invitation-code/redeem
  • Auth: none declared

Request body

codestring 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.

user_idstring uuid required

Changes