---
title: "Update Onboarding Progress"
method: PUT
path: "/v0/user/onboarding"
tags: ["User"]
---

# Update Onboarding Progress

`PUT /v0/user/onboarding`

Update the current user's onboarding progress.

The step_data is validated based on the current_step to ensure
only valid fields are stored.

## Request body

- OnboardingStatusUpdateRequest — Request to update user's onboarding status. The current_step indicates WHERE TO RESUME next time: - After registration, set to "workspace_setup" - After completing workspace setup, set to "completed" The step_data accumulates information from all completed steps.
  - `current_step` 'workspace_setup' | 'completed', required
  - `step_data` object, nullable

## Response `200`

Successful Response

- OnboardingStatusDetailedResponse — Detailed response for user's onboarding status.
  - `user_id` string, required
  - `current_step` 'workspace_setup' | 'completed', required
  - `step_data` OnboardingStepDataResponse, required — Accumulated step data from onboarding progress. Data is accumulated as user progresses through steps. All fields are optional since they're filled in progressively.
    - `selected_type` 'personal' | 'organization', nullable
    - `organization_id` string, nullable
    - `organization_name` string, nullable
    - `completed_at` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)