---
title: "Complete Onboarding"
method: POST
path: "/users/me/complete-onboarding"
tags: ["users", "users"]
---

# Complete Onboarding

`POST /users/me/complete-onboarding`

Mark onboarding complete and place the user in exactly one org.

`kind: "solo"` creates a personal org; `kind: "team"` joins the user to the
org that has claimed their email domain. Org write + flag flip share a single
DB transaction so partial state is impossible.

## Request body

- union
  - SoloOnboarding
    - `kind` 'solo', required
  - TeamOnboarding
    - `kind` 'team', required

## Response `200`

Successful Response

- CompleteOnboardingResponse
  - `profile` UserProfileResponse, required
    - `user_id` string, required
    - `display_name` string, required
    - `avatar_url` string, nullable, required
    - `email` string, nullable, required
    - `needs_onboarding` boolean
    - `current_org` CurrentOrg — The viewer's own org — adds the fields the renderer needs to render settings without a second round-trip: the toggle value plus the viewer's role for owner-gated UI.
      - `id` string, required
      - `name` string, required
      - `claimed_domain` string, nullable
      - `external_sharing_enabled` boolean, required
      - `viewer_role` 'owner' | 'admin' | 'member', required
      - `is_personal` boolean, required — True when the org has no claimed domain — i.e. it is a personal/solo org.
  - `current_org` OrgRefDTO, required — Lightweight {id, name, is_personal} pointer used by settings and onboarding flows.
    - `id` string, required
    - `name` string, required
    - `claimed_domain` string, nullable
    - `is_personal` boolean, required — True when the org has no claimed domain — i.e. it is a personal/solo org.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)