# POST /api/v1/onboarding/submit

Проверить полноту анкеты и отправить на разбор.

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

## Описание

Проверить полноту анкеты и отправить на разбор: обязательны role, business, scenario, level, aiTools, budget, tools, time, hardware, os, goal, about; при «Другое» также scenarioOther / aiToolsOther / toolsOther. Socials, website и setup необязательны. Затем состояние `in_review`, уведомление в outbox. Повторная отправка готового состояния идемпотентна. Не хватает полей – `ONBOARDING_INCOMPLETE` с issues.

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

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

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

**Body:** не требуется.

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

**Ответ:** 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": "claude"
  },
  "completedAt": "2026-11-04T10:00:00Z"
}
```

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

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

```bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/onboarding/submit \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space'
```

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

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

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