---
title: "Redeem Invitation Code"
method: POST
path: "/api/v1/invitation-code/redeem"
tags: ["External: Mobile SDK"]
---

# Redeem Invitation Code

`POST /api/v1/invitation-code/redeem`

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.

## Request body

- UserInvitationCodeRedeem — API input for redeeming an invitation code.
  - `code` string, required

## Response `200`

Successful Response

- InvitationCodeRedeemResponse — Redeem response with user_id included.
  - `access_token` string, required
  - `token_type` string
  - `refresh_token` string, nullable
  - `expires_in` integer, nullable
  - `user_id` string, uuid, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/revisions/8c15cc93d210/schema)