External: Mobile SDK

Generate Invitation Code

Generate a single-use invitation code for standalone SDK onboarding.

Issues a single-use code that a mobile app can redeem (via POST /api/v1/invitation-code/redeem) to receive SDK access and refresh tokens - without your backend having to mint and forward a token itself. Any previously generated codes for this user are marked as expired.

This is a convenience mechanism for apps with no backend of their own (for example the Open Wearables app or quick manual testing). It is not the standard integration path: if your app authenticates users against your own backend, mint a token directly with POST /api/v1/users/{user_id}/token instead.

Requires developer authentication.

post/api/v1/users/{user_id}/invitation-code

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/users/{user_id}/invitation-code
  • Auth: OAuth 2 (password, token URL /api/v1/auth/login)

Path parameters

user_idstring uuid required

Response

Successful Response

idstring uuid required
codestring required
user_idstring uuid required
expires_atstring date-time required
created_atstring date-time required

Changes

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