---
title: "Redeem a JOIN code for the signed-in principal (transactional; grant with the burn)"
method: POST
path: "/api/invite-codes/redeem"
tags: ["invites"]
---

# Redeem a JOIN code for the signed-in principal (transactional; grant with the burn)

`POST /api/invite-codes/redeem`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/invite-codes/redeem`
- Auth: none declared

## Request body

- RedeemBody
  - `code` string, required

## Response `200`

Joined.

- RedeemResponse
  - `orgId` string, required
  - `role` 'org_admin' | 'member', required
  - `groupIds` string[], required
  - `alreadyMember` boolean, required

## Other responses

- `400`: invite_code_invalid (unknown, revoked, expired) · invite_code_exhausted.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)