latestOpenAPI 3.1.02026-08-19125152233.3 KB

8c15cc93d210

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

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