---
title: "Replace onboarding question responses after onboarding is complete"
method: PUT
path: "/api/users/onboarding/responses"
tags: ["Users"]
---

# Replace onboarding question responses after onboarding is complete

`PUT /api/users/onboarding/responses`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/users/onboarding/responses`
- Auth: HTTP bearer

POST /users/onboarding is one-shot. Use this to change answers afterwards. Only the questions present in the body are touched; their previous answers are replaced.

## Request body

- object
  - `responses` object[], required: Same item shape as /users/onboarding. Each entry carries either answer_ids or response_text, never both.
    - `question_id` string, uuid, required
    - `answer_ids` string[]
    - `response_text` string

## Response `200`

Responses replaced

## Other responses

- `400`: Validation failed, or onboarding not completed yet (use POST /users/onboarding)

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)