# PUT /api/v1/onboarding/setup

Выбрать сетап отдельно от анкеты в любом статусе, не меняя остальные ответы и статус.

| Поле | Значение |
| --- | --- |
| URL | `PUT https://aos.edgelab.space/api/v1/onboarding/setup` |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 `CREDENTIAL_NOT_ALLOWED`) |
| operationId | `onboardingSetup` |

## Описание

Выбрать сетап отдельно от анкеты в любом статусе, не меняя остальные ответы и статус; допустимые setup ids указаны в схеме. Ответ – обновлённая анкета.

**Auth:** сессия кабинета (cookie) / TMA bearer. **Scope:** не требуется.

**Path:** параметров нет.

**Query:** нет объявленных полей.

**Body:** `application/json`, [OnboardingSetupRequest](/docs/schemas#onboardingsetuprequest). Все вложенные поля и варианты – по ссылке.

| Поле    | Тип       | Обязательно | Ограничения |
| ------- | --------- | ----------- | ----------- |
| `setup` | `SetupId` | да          | –           |

**Ответ · статус и структура**

**Ответ:** 200 `application/json`, [Onboarding](/docs/schemas#onboarding).

Краткая форма: `{ schemaVersion: 2, status: OnboardingStatus, step: integer, answers: OnboardingDraft, completedAt: string | null }`.

Пример JSON; значения демонстрационные.

```json
{
  "schemaVersion": 2,
  "status": "in_review",
  "step": 12,
  "answers": {
    "role": "Основатель бизнеса",
    "business": "Развиваю студию дизайна, в команде 5 человек",
    "scenario": [
      "Продажи и заявки",
      "Документы и отчёты"
    ],
    "level": "Пользуюсь ChatGPT/Claude каждый день",
    "aiTools": [
      "ChatGPT",
      "Claude"
    ],
    "budget": "50_100",
    "tools": [
      "Telegram",
      "Notion",
      "Битрикс24",
      "Другое"
    ],
    "toolsOther": "Figma",
    "time": "3–5 часов в неделю",
    "hardware": [
      "Платный публичный VPN",
      "Нужна помощь с настройкой"
    ],
    "os": "macOS",
    "goal": "Хочу агента, который разбирает заявки и готовит сводку по продажам",
    "about": "Работаю из Москвы, удобнее учиться по вечерам.",
    "socialsPersonal": [
      "@studio_founder",
      "https://vk.com/studio.founder"
    ],
    "socialsBusiness": [
      "https://t.me/studio_design_channel"
    ],
    "website": "https://studio-design.ru",
    "setup": "hermes"
  },
  "completedAt": "2026-11-04T10:00:00Z"
}
```

**Ошибки:** `401 UNAUTHENTICATED`, `403 NO_ENTITLEMENT`, `503 ENTITLEMENT_UNAVAILABLE`, `429 RATE_LIMITED`, `403 ORIGIN_REJECTED`, `422 VALIDATION_FAILED`, `403 CREDENTIAL_NOT_ALLOWED`; [общие ошибки](/docs/errors).

**Лимиты:** Отдельного throttle в коде нет.

**Запрос · JSON**

```json
{
  "setup": "hermes"
}
```

**Пример · curl**

```bash
curl -sS -i -X PUT https://aos.edgelab.space/api/v1/onboarding/setup \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"setup":"hermes"}'
```

## Ответы по контракту

Тело запроса: [OnboardingSetupRequest](/docs/schemas#onboardingsetuprequest).

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [Onboarding](/docs/schemas#onboarding) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `onboardingSetup`.
