{"openapi":"3.1.0","info":{"title":"ctrl-board cloud-service","description":"Heartbeat ingest + command queue + REST для IoT-устройств.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/api/v1/auth/register/start":{"post":{"tags":["auth"],"summary":"Register Start","operationId":"register_start_api_v1_auth_register_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterStartIn"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/register/verify":{"post":{"tags":["auth"],"summary":"Register Verify","operationId":"register_verify_api_v1_auth_register_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCodeIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login/start":{"post":{"tags":["auth"],"summary":"Login Start","operationId":"login_start_api_v1_auth_login_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginStartIn"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login/verify":{"post":{"tags":["auth"],"summary":"Login Verify","operationId":"login_verify_api_v1_auth_login_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCodeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/verify-by-token":{"post":{"tags":["auth"],"summary":"Verify By Token","description":"Унифицированный эндпоинт для clickable-ссылки из письма.\n\nВыдаёт JWT и для register, и для login — разница только в том, что\nдля register сначала создаём User'а.","operationId":"verify_by_token_api_v1_auth_verify_by_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyTokenIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/refresh":{"post":{"tags":["auth"],"summary":"Refresh","description":"Обмен refresh-token на новую пару (access + refresh).\n\nRotation: старый refresh сразу revoke'ится. last_used_at — для отладки.\nAuth не через Bearer — refresh сам себе авторизация. Используется когда\naccess истёк (api.js на 401 фронта).","operationId":"refresh_api_v1_auth_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"Revoke конкретного refresh-token'а (текущая сессия).\n\nИдемпотентно: если токен невалидный/уже отозванный — всё равно 204\n(не утекаем бит «существует ли такой токен»). Access-token при этом\nостаётся валидным до своего exp — что ок: 30 мин, плата уже не сможет\nrefresh'нуть (this refresh revoked'ed) → следующий 401 кикнет в логин.","operationId":"logout_api_v1_auth_logout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshIn"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["auth"],"summary":"Me","operationId":"me_api_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"delete":{"tags":["auth"],"summary":"Delete Me","description":"Удалить свой аккаунт. Требует подтверждение пароля.\n\nКаскадно стираются (по FK ondelete='CASCADE' + ORM cascade):\n  - owned projects → все вложенные devices/commands/groups/invites/members/notes;\n  - membership в чужих проектах (сами проекты остаются);\n  - membership в группах;\n  - заметки автора в чужих проектах.\nПоля invite.created_by / invite.used_by_user_id обнуляются (SET NULL).","operationId":"delete_me_api_v1_auth_me_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountIn"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/auth/me/notifications":{"put":{"tags":["auth"],"summary":"Update Notifications","description":"Обновить настройки email-уведомлений (пока только notify_notes).","operationId":"update_notifications_api_v1_auth_me_notifications_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationSettingsIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/auth/change-password":{"post":{"tags":["auth"],"summary":"Change Password","description":"Сменить свой пароль. Старый пароль обязательно проверяется.\n\nJWT не инвалидируется — текущая сессия продолжает работать. Если хочется\n«выйти со всех устройств» — нужен отдельный механизм (jti-blacklist),\nв первой итерации не делаем.","operationId":"change_password_api_v1_auth_change_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordIn"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/projects":{"get":{"tags":["projects"],"summary":"List Projects","operationId":"list_projects_api_v1_projects_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProjectOut"},"type":"array","title":"Response List Projects Api V1 Projects Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"tags":["projects"],"summary":"Create Project","operationId":"create_project_api_v1_projects_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/projects/{project_id}":{"get":{"tags":["projects"],"summary":"Get Project","operationId":"get_project_api_v1_projects__project_id__get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["projects"],"summary":"Update Project","operationId":"update_project_api_v1_projects__project_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["projects"],"summary":"Delete Project","operationId":"delete_project_api_v1_projects__project_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/announcements":{"get":{"tags":["projects"],"summary":"List Project Announcements","description":"CCB-D: активные admin-баннеры. Видны даже на заблокированном проекте —\nспециально, чтобы юзер знал почему блок (используется allow_blocked\nmembership-check).","operationId":"list_project_announcements_api_v1_projects__project_id__announcements_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AnnouncementPublicOut"},"title":"Response List Project Announcements Api V1 Projects  Project Id  Announcements Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/members":{"get":{"tags":["members"],"summary":"List Members","operationId":"list_members_api_v1_projects__project_id__members_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberOut"},"title":"Response List Members Api V1 Projects  Project Id  Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/members/{user_id}":{"put":{"tags":["members"],"summary":"Update Member Role","operationId":"update_member_role_api_v1_projects__project_id__members__user_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["members"],"summary":"Remove Member","description":"Удалить member'а из проекта.\n\n- User может удалить себя сам (если не owner — owner'у нужно сперва передать\n  ownership / удалить проект).\n- Owner может удалить любого, кроме себя.","operationId":"remove_member_api_v1_projects__project_id__members__user_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/invites":{"post":{"tags":["members"],"summary":"Create Invite","description":"Invite в проект, опционально привязанный к конкретным группам (multi).\n\nbody.group_ids:\n  - None или [] → весь проект, включая будущие группы.\n  - [g1, g2, ...] → user попадёт ровно в эти группы (плюс ProjectMember\n    проекта с указанной ролью, если ещё не member).\nВсе group_ids проверяются: должны существовать и принадлежать проекту.","operationId":"create_invite_api_v1_projects__project_id__invites_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["members"],"summary":"List Invites","description":"Список приглашений проекта.\n\nPhase 17.6: project-admin/owner видит все приглашения. Group-admin видит:\n  - приглашения, которые он создал сам (created_by);\n  - приглашения, чьи group_ids пересекаются с группами, где он admin.\nОстальные (viewer/member без group-admin прав) — 403.","operationId":"list_invites_api_v1_projects__project_id__invites_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InviteOut"},"title":"Response List Invites Api V1 Projects  Project Id  Invites Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/invites/{invite_id}":{"delete":{"tags":["members"],"summary":"Revoke Invite","description":"Отозвать приглашение. Phase 17.6: project-admin отзывает любое; group-admin\nотзывает свои (created_by) или те, что ведут в его group-admin группы.","operationId":"revoke_invite_api_v1_projects__project_id__invites__invite_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"invite_id","in":"path","required":true,"schema":{"type":"integer","title":"Invite Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/invites/{token}":{"get":{"tags":["members"],"summary":"Preview Invite","operationId":"preview_invite_api_v1_invites__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitePreviewOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/invites/{token}/accept":{"post":{"tags":["members"],"summary":"Accept Invite","operationId":"accept_invite_api_v1_invites__token__accept_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Accept Invite Api V1 Invites  Token  Accept Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups":{"get":{"tags":["groups"],"summary":"List Groups","description":"Список групп. Privacy (Phase 17.5): viewer/member видит только группы,\nв которых он DeviceGroupMember. Постоянный project-wide доступ и owner/admin\nвидят все группы проекта.\n\nPhase 17.6: каждая группа в ответе содержит my_role — роль user'а В ЭТОЙ\nГРУППЕ. Для project-admin/owner — всегда \"admin\". UI использует это, чтобы\nпоказывать админские контролы group-admin'у, а не только project-admin'у.","operationId":"list_groups_api_v1_projects__project_id__groups_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeviceGroupOut"},"title":"Response List Groups Api V1 Projects  Project Id  Groups Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["groups"],"summary":"Create Group","operationId":"create_group_api_v1_projects__project_id__groups_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceGroupIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceGroupOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups/{group_id}":{"put":{"tags":["groups"],"summary":"Update Group","operationId":"update_group_api_v1_projects__project_id__groups__group_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceGroupIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceGroupOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["groups"],"summary":"Delete Group","operationId":"delete_group_api_v1_projects__project_id__groups__group_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups/{group_id}/visibility":{"patch":{"tags":["groups"],"summary":"Set Group Visibility","description":"Переключить личное скрытие группы для текущего user'а в этом проекте.\nИдемпотентно — повторный hidden=true / hidden=false не падает.","operationId":"set_group_visibility_api_v1_projects__project_id__groups__group_id__visibility_patch","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupVisibilityIn"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups/{group_id}/entities":{"get":{"tags":["groups"],"summary":"List Group Entities","description":"Все реле/сенсоры в группе. Viewer проекта видит — это содержание ACL,\nнужное для рендера дашборда.","operationId":"list_group_entities_api_v1_projects__project_id__groups__group_id__entities_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GroupEntityOut"},"title":"Response List Group Entities Api V1 Projects  Project Id  Groups  Group Id  Entities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["groups"],"summary":"Replace Group Entities","description":"Bulk replace всего набора entities группы.\n\nИдемпотентно — UI с чекбоксами просто шлёт полный текущий список после\nкаждого изменения. Все переданные devices должны быть в этом же проекте,\nиначе 400.\n\nPhase 17.6: состав entities (какие реле/сенсоры входят в группу) меняет\nТОЛЬКО project-admin/owner — это «расширение прав». group-admin может\nтолько управлять участниками и инвайтами своей группы, но не давать\nгруппе доступ к новому железу.","operationId":"replace_group_entities_api_v1_projects__project_id__groups__group_id__entities_put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupEntitiesReplaceIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GroupEntityOut"},"title":"Response Replace Group Entities Api V1 Projects  Project Id  Groups  Group Id  Entities Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups/{group_id}/members":{"get":{"tags":["groups"],"summary":"List Group Members","operationId":"list_group_members_api_v1_projects__project_id__groups__group_id__members_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GroupMemberOut"},"title":"Response List Group Members Api V1 Projects  Project Id  Groups  Group Id  Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["groups"],"summary":"Add Group Member","description":"Добавить участника по email. Пользователь должен уже быть зарегистрирован\nв системе И быть participant'ом проекта (нельзя дать доступ к группе тому,\nкто вообще не в проекте — сначала нужен invite в проект).","operationId":"add_group_member_api_v1_projects__project_id__groups__group_id__members_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMemberAddIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMemberOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/groups/{group_id}/members/{user_id}":{"put":{"tags":["groups"],"summary":"Update Group Member Role","description":"Сменить роль участника в группе. Доступно group-admin или project-admin+.","operationId":"update_group_member_role_api_v1_projects__project_id__groups__group_id__members__user_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMemberUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMemberOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["groups"],"summary":"Remove Group Member","operationId":"remove_group_member_api_v1_projects__project_id__groups__group_id__members__user_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/devices":{"get":{"tags":["devices"],"summary":"List Devices","description":"List плат с ACL-фильтрацией (Phase 17):\n- owner/admin видят все платы и все entities в last_state.\n- member/viewer видят только платы, у которых хотя бы одно реле/сенсор\n  входит в их группы. last_state.devices обрезается до видимых entities;\n  платы без видимых entities скрываются полностью.","operationId":"list_devices_api_v1_projects__project_id__devices_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeviceOut"},"title":"Response List Devices Api V1 Projects  Project Id  Devices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["devices"],"summary":"Create Device","operationId":"create_device_api_v1_projects__project_id__devices_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceCreatedOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/devices/{device_id}":{"get":{"tags":["devices"],"summary":"Get Device","description":"Single device. Если не-admin'у не видно ни одного entity — 404 (privacy:\nне палим существование платы, к которой нет доступа).","operationId":"get_device_api_v1_projects__project_id__devices__device_id__get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["devices"],"summary":"Update Device","operationId":"update_device_api_v1_projects__project_id__devices__device_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["devices"],"summary":"Delete Device","operationId":"delete_device_api_v1_projects__project_id__devices__device_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/devices/{device_id}/rotate-key":{"post":{"tags":["devices"],"summary":"Rotate Api Key","description":"Сгенерить новый api_key. Старый сразу инвалидируется. Возвращается ОДИН РАЗ.","operationId":"rotate_api_key_api_v1_projects__project_id__devices__device_id__rotate_key_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceCreatedOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/devices/{device_id}/commands":{"post":{"tags":["commands"],"summary":"Issue Command","operationId":"issue_command_api_v1_projects__project_id__devices__device_id__commands_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommandIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cloud_service__schemas__command__CommandOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["commands"],"summary":"List Commands","description":"Список команд устройства. pending_only=true — только не доставленные.","operationId":"list_commands_api_v1_projects__project_id__devices__device_id__commands_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}},{"name":"pending_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Pending Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/cloud_service__schemas__command__CommandOut"},"title":"Response List Commands Api V1 Projects  Project Id  Devices  Device Id  Commands Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/devices/{device_id}/commands/{cmd_id}":{"delete":{"tags":["commands"],"summary":"Revoke Command","description":"Revoke неотданной команды.\n\nПросто двигает expires_at в прошлое — heartbeat-handler перестаёт её\nвидеть, повторный revoke идемпотентен.\n\nЕсли команда уже доставлена (delivered_at != NULL) — 409: плата уже\nзабрала, отозвать невозможно. acked_at тоже непонятно как откатывать.","operationId":"revoke_command_api_v1_projects__project_id__devices__device_id__commands__cmd_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}},{"name":"cmd_id","in":"path","required":true,"schema":{"type":"integer","title":"Cmd Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["commands"],"summary":"Get Command","description":"Статус одной команды — для лёгкого polling'а acked_at без скачивания всей очереди.","operationId":"get_command_api_v1_projects__project_id__devices__device_id__commands__cmd_id__get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}},{"name":"cmd_id","in":"path","required":true,"schema":{"type":"integer","title":"Cmd Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cloud_service__schemas__command__CommandOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/devices/{uuid}/commands/{cmd_id}/ack":{"post":{"tags":["commands"],"summary":"Ack Command","operationId":"ack_command_api_v1_devices__uuid__commands__cmd_id__ack_post","parameters":[{"name":"uuid","in":"path","required":true,"schema":{"type":"string","title":"Uuid"}},{"name":"cmd_id","in":"path","required":true,"schema":{"type":"integer","title":"Cmd Id"}},{"name":"X-Device-Uuid","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Uuid"}},{"name":"X-Device-Ts","in":"header","required":true,"schema":{"type":"integer","title":"X-Device-Ts"}},{"name":"X-Device-Sig","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Sig"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/notes":{"get":{"tags":["notes"],"summary":"List Notes","description":"Последние NOTE_LIMIT заметок ASC по created_at (как чат — старые сверху).\nPrivacy 404 на чужой проект через get_member_project.","operationId":"list_notes_api_v1_projects__project_id__notes_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProjectNoteOut"},"title":"Response List Notes Api V1 Projects  Project Id  Notes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["notes"],"summary":"Create Note","description":"Создать заметку. Может любой участник (включая viewer).\n\nПосле коммита запускается фоновый фан-аут email-уведомлений всем участникам\nпроекта (минус автор), у которых notify_notes=true и истёк cooldown.","operationId":"create_note_api_v1_projects__project_id__notes_post","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectNoteIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectNoteOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/notes/{note_id}":{"delete":{"tags":["notes"],"summary":"Delete Note","description":"Удалить заметку. Author или project-admin/owner.","operationId":"delete_note_api_v1_projects__project_id__notes__note_id__delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"integer","title":"Project Id"}},{"name":"note_id","in":"path","required":true,"schema":{"type":"integer","title":"Note Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/build/catalog":{"get":{"tags":["firmwares-builder"],"summary":"Build Catalog","description":"Public, source-derived plugin catalog; never maintained as a UI whitelist.","operationId":"build_catalog_api_v1_firmwares_build_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Build Catalog Api V1 Firmwares Build Catalog Get"}}}}}}},"/api/v1/firmwares/build":{"post":{"tags":["firmwares-builder"],"summary":"Request Build","operationId":"request_build_api_v1_firmwares_build_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Config"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Request Build Api V1 Firmwares Build Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/firmwares/build/runners/health":{"get":{"tags":["firmwares-builder"],"summary":"Runners Health","operationId":"runners_health_api_v1_firmwares_build_runners_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Runners Health Api V1 Firmwares Build Runners Health Get"}}}}}}},"/api/v1/firmwares/build/{hash}/status":{"get":{"tags":["firmwares-builder"],"summary":"Build Status","operationId":"build_status_api_v1_firmwares_build__hash__status_get","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","title":"Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Build Status Api V1 Firmwares Build  Hash  Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/build/{hash}/download/{kind}":{"get":{"tags":["firmwares-builder"],"summary":"Download Custom","operationId":"download_custom_api_v1_firmwares_build__hash__download__kind__get","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","title":"Hash"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares":{"get":{"tags":["firmwares"],"summary":"List Firmwares","description":"Список прошивок из папки. Фильтры по platform/channel опциональны.\nДоступно любому залогиненному (для UI выбора версии при OTA-команде).\n\nPhase OTA-FS: возвращаем по одной записи на (platform, channel, version) с\nобъединёнными firmware/littlefs. Backward compat — поля верхнего уровня\n(id, version, size, sha256) указывают на FIRMWARE; littlefs-двойник — в\n`littlefs: {id, size, sha256}` (None если соседа нет).","operationId":"list_firmwares_api_v1_firmwares_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Firmwares Api V1 Firmwares Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/public-latest":{"get":{"tags":["firmwares"],"summary":"List Latest Public","description":"CCB-137: public endpoint для landing'а — последняя версия per platform\n+ download URLs (без auth). Раздаются ВСЕ платформы что лежат в volume\n(esp8266 + esp32 + esp01s если есть), только `channel=stable`.\n\nКанал ограничен до stable: dev/beta не для публичного скачивания на\nлендинге, юзер их получит через cloud OTA-dropdown с JWT-auth.\n\nФормат ответа — list of:\n  {platform, version, firmware: {id, url, size, sha256},\n   littlefs: {id, url, size, sha256} | null,\n   notes: markdown | null}","operationId":"list_latest_public_api_v1_firmwares_public_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Latest Public Api V1 Firmwares Public Latest Get"}}}}}}},"/api/v1/firmwares/presets":{"get":{"tags":["firmwares"],"summary":"List Presets","description":"CB-188 firmware builder: public list of pre-built preset firmwares\nс metadata (title, board, memory footprint, enabled plugins). Использует\nlanding kavlev.ru/builder для рендеринга preset-cards.\n\nИсточник: /app/firmwares/presets/presets.json (создаётся CI ctrl-board'а\nпри release tag'е). Cloud дополняет каждый preset актуальным size+sha256\nиз файла .bin (lazy compute, RAM-cached как `_sha256_of`).","operationId":"list_presets_api_v1_firmwares_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Presets Api V1 Firmwares Presets Get"}}}}}}},"/api/v1/firmwares/preset/{preset_name}/latest/{kind}":{"get":{"tags":["firmwares"],"summary":"Download Preset","description":"CB-188: download .bin для конкретного preset'а. Public, без auth.\nkind ∈ {firmware, littlefs}. Path-traversal защита: preset_name строго\nчерез `_PRESET_NAME_RE`, kind через whitelist.","operationId":"download_preset_api_v1_firmwares_preset__preset_name__latest__kind__get","parameters":[{"name":"preset_name","in":"path","required":true,"schema":{"type":"string","title":"Preset Name"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/{firmware_id}/public":{"get":{"tags":["firmwares"],"summary":"Download Firmware Public","description":"CCB-137: public download .bin для landing'а — без auth. Защита от\npath traversal через `_FILENAME_RE`. Firmware-артефакты публичные\n(они и так лежат на GitHub Release для open-source проектов).","operationId":"download_firmware_public_api_v1_firmwares__firmware_id__public_get","parameters":[{"name":"firmware_id","in":"path","required":true,"schema":{"type":"string","title":"Firmware Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/{firmware_id}/download":{"get":{"tags":["firmwares"],"summary":"Download Firmware","description":"Плата качает .bin по HMAC-подписанному GET. firmware_id = имя файла.\nЗащита от path traversal — проверяем regex имени.","operationId":"download_firmware_api_v1_firmwares__firmware_id__download_get","parameters":[{"name":"firmware_id","in":"path","required":true,"schema":{"type":"string","title":"Firmware Id"}},{"name":"X-Device-Uuid","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Uuid"}},{"name":"X-Device-Ts","in":"header","required":true,"schema":{"type":"integer","title":"X-Device-Ts"}},{"name":"X-Device-Sig","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Sig"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/firmwares/{firmware_id}":{"get":{"tags":["firmwares"],"summary":"Download Firmware User","description":"User-facing download .bin для ручной заливки через USB / web-UI платы.\nJWT-auth, не HMAC (плата идёт через /download endpoint выше).","operationId":"download_firmware_user_api_v1_firmwares__firmware_id__get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"firmware_id","in":"path","required":true,"schema":{"type":"string","title":"Firmware Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrations/providers":{"get":{"tags":["integrations"],"summary":"List Providers","description":"Для каждого known провайдера: enabled (client'я зарегистрирован) и linked (юзер привязал).","operationId":"list_providers_api_v1_integrations_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProviderStatus"},"type":"array","title":"Response List Providers Api V1 Integrations Providers Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/integrations/yandex":{"delete":{"tags":["integrations"],"summary":"Unlink Yandex","operationId":"unlink_yandex_api_v1_integrations_yandex_delete","responses":{"204":{"description":"Successful Response"}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/integrations/marusya":{"delete":{"tags":["integrations"],"summary":"Unlink Marusya","operationId":"unlink_marusya_api_v1_integrations_marusya_delete","responses":{"204":{"description":"Successful Response"}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/integrations/entities":{"get":{"tags":["integrations"],"summary":"List Entities","description":"Все entity юзера + текущие voice-overrides (или defaults если row нет).\n\ngroup_names (fix #CCB-24) — список имён групп per entity, отсортированных\nпо DeviceGroup.sort_order. UI использует первую группу как placeholder\nдля voice_room.","operationId":"list_entities_api_v1_integrations_entities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EntityVoiceOut"},"type":"array","title":"Response List Entities Api V1 Integrations Entities Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/api/v1/integrations/entities/{device_id}/{entity_kind}/{entity_id}":{"put":{"tags":["integrations"],"summary":"Upsert Entity Voice","description":"Создать/обновить DeviceEntityVoice для (device_id, kind, entity_id).\n\nЮзер должен иметь visible-доступ к entity (group-ACL).","operationId":"upsert_entity_voice_api_v1_integrations_entities__device_id___entity_kind___entity_id__put","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"device_id","in":"path","required":true,"schema":{"type":"integer","title":"Device Id"}},{"name":"entity_kind","in":"path","required":true,"schema":{"type":"string","title":"Entity Kind"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"integer","title":"Entity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityVoiceIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityVoiceOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mqtt/auth":{"post":{"tags":["mqtt-webhook"],"summary":"Mqtt Auth","description":"EMQX CONNECT auth. Возвращаем `allow`/`deny`.\n\nEMQX по умолчанию шлёт 200 OK + JSON. Если мы вернём 5xx — EMQX retry'нет\nили просто deny (зависит от конфига); мы не возвращаем ошибки — всегда 200\nс явным решением.","operationId":"mqtt_auth_api_v1_mqtt_auth_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_AuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_Decision"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mqtt/acl":{"post":{"tags":["mqtt-webhook"],"summary":"Mqtt Acl","description":"EMQX ACL check на каждый pub/sub (с TTL-кешем 60s в EMQX).\n\nБД не дёргаем — авторизация полностью производится по username (доверяем\nчто connect-auth уже подтвердил кто это).","operationId":"mqtt_acl_api_v1_mqtt_acl_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_AclRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_Decision"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/devices/{uuid}/heartbeat":{"post":{"tags":["device"],"summary":"Post Heartbeat","operationId":"post_heartbeat_api_v1_devices__uuid__heartbeat_post","parameters":[{"name":"uuid","in":"path","required":true,"schema":{"type":"string","title":"Uuid"}},{"name":"X-Device-Uuid","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Uuid"}},{"name":"X-Device-Ts","in":"header","required":true,"schema":{"type":"integer","title":"X-Device-Ts"}},{"name":"X-Device-Sig","in":"header","required":true,"schema":{"type":"string","title":"X-Device-Sig"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartbeatIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartbeatOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/contact/seed":{"post":{"tags":["contact"],"summary":"Seed Contact","description":"Создать AdminDialog для contact-form submission.\n\nИдемпотентен по hash — повторный POST с тем же hash вернёт существующий\ndialog (action='attached'), не дублирует rows.","operationId":"seed_contact_api_v1_contact_seed_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactSeedIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactSeedOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/authorize":{"get":{"tags":["oauth"],"summary":"Authorize Get","description":"Шаг 1: проверка параметров, форма consent (или 302 на /login).","operationId":"authorize_get_oauth_authorize_get","parameters":[{"name":"response_type","in":"query","required":true,"schema":{"type":"string","title":"Response Type"}},{"name":"client_id","in":"query","required":true,"schema":{"type":"string","title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","title":"Redirect Uri"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"smart_home","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["oauth"],"summary":"Authorize Post","description":"Шаг 2: юзер нажал «Разрешить» или «Отказать».","operationId":"authorize_post_oauth_authorize_post","security":[{"OAuth2PasswordBearer":[]}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_authorize_post_oauth_authorize_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/authorize/_session":{"get":{"tags":["oauth"],"summary":"Authorize Session","description":"Endpoint для consent UI: получить email текущего юзера, чтобы показать\n\"Вы вошли как user@x\". UI его дёргает с Bearer-токеном из localStorage.","operationId":"authorize_session_oauth_authorize__session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Authorize Session Oauth Authorize  Session Get"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oauth/token":{"post":{"tags":["oauth"],"summary":"Token Endpoint","description":"Обмен code или refresh на пару access+refresh.\n\nRFC 6749 §4.1.3 (code-flow) и §6 (refresh-flow). Аутентификация клиента —\nдвумя способами, как и требует §2.3.1:\n\n  - client_secret_post: client_id/client_secret в теле формы (так шлёт\n    Яндекс, и до CCB-334 поддерживался только этот вариант);\n  - client_secret_basic: HTTP Basic с client_id в роли логина (так шлёт\n    Сбер — его oauth2-библиотека по умолчанию использует именно Basic, и\n    привязка падала с «Missing client credentials», хотя креды были).\n\nСпека называет Basic обязательным к поддержке, а форму — опциональной,\nтак что правильнее принимать оба. Форма имеет приоритет: если клиент\nприслал креды и там, и там, берём явные из тела.","operationId":"token_endpoint_oauth_token_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_token_endpoint_oauth_token_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1.0/":{"post":{"tags":["yandex-smart-home"],"summary":"Dialog Stub","description":"Заглушка под Yandex Dialogs Console tester (CCB-34).\n\nConsole шлёт SimpleUtterance POST на endpoint URL для всех навыков\nнезависимо от типа. Реальный Smart Home flow эту ручку не использует\n(он идёт через /v1.0/user/devices etc.), но Console-тестер без неё\nругается «Извините, навык не отвечает» и блокирует тестирование.\n\nОтдаём минимально валидный Dialog-ответ с end_session=true.","operationId":"dialog_stub_v1_0__post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dialog Stub V1 0  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"tags":["yandex-smart-home"],"summary":"Health Head","description":"Yandex пингует перед каждым запросом. Просто 200 OK.","operationId":"health_head_v1_0__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1.0/user/devices":{"get":{"tags":["yandex-smart-home"],"summary":"List Devices","operationId":"list_devices_v1_0_user_devices_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Devices V1 0 User Devices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1.0/user/devices/query":{"post":{"tags":["yandex-smart-home"],"summary":"Query Devices","operationId":"query_devices_v1_0_user_devices_query_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Query Devices V1 0 User Devices Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1.0/user/devices/action":{"post":{"tags":["yandex-smart-home"],"summary":"Action Devices","operationId":"action_devices_v1_0_user_devices_action_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Action Devices V1 0 User Devices Action Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1.0/user/unlink":{"post":{"tags":["yandex-smart-home"],"summary":"Unlink User","description":"Юзер отвязал аккаунт в приложении Алисы — revoke все провайдер-токены\nэтого юзера для этого client. VoiceIntegration row оставляем (linked_at\nпоказывает что когда-то была связь), либо чистим — по спеке Yandex просто\nговорит «забудьте про юзера», ничего конкретного.","operationId":"unlink_user_v1_0_user_unlink_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unlink User V1 0 User Unlink Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marusya/":{"post":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"Dialog Stub","description":"Заглушка под Yandex Dialogs Console tester (CCB-34).\n\nConsole шлёт SimpleUtterance POST на endpoint URL для всех навыков\nнезависимо от типа. Реальный Smart Home flow эту ручку не использует\n(он идёт через /v1.0/user/devices etc.), но Console-тестер без неё\nругается «Извините, навык не отвечает» и блокирует тестирование.\n\nОтдаём минимально валидный Dialog-ответ с end_session=true.","operationId":"dialog_stub_marusya__post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dialog Stub Marusya  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"Health Head","description":"Yandex пингует перед каждым запросом. Просто 200 OK.","operationId":"health_head_marusya__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/marusya/user/devices":{"get":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"List Devices","operationId":"list_devices_marusya_user_devices_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Devices Marusya User Devices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marusya/user/devices/query":{"post":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"Query Devices","operationId":"query_devices_marusya_user_devices_query_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Query Devices Marusya User Devices Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marusya/user/devices/action":{"post":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"Action Devices","operationId":"action_devices_marusya_user_devices_action_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Action Devices Marusya User Devices Action Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marusya/user/unlink":{"post":{"tags":["marusya-smart-home","yandex-smart-home"],"summary":"Unlink User","description":"Юзер отвязал аккаунт в приложении Алисы — revoke все провайдер-токены\nэтого юзера для этого client. VoiceIntegration row оставляем (linked_at\nпоказывает что когда-то была связь), либо чистим — по спеке Yandex просто\nговорит «забудьте про юзера», ничего конкретного.","operationId":"unlink_user_marusya_user_unlink_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unlink User Marusya User Unlink Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sber/v1/ping":{"get":{"tags":["sber-smart-home"],"summary":"Ping","description":"Проверка доступности. Авторизации быть не должно — Сбер пингует без\nпользовательского контекста, и 401 здесь означал бы для него, что\nинтеграция лежит.","operationId":"ping_sber_v1_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sber/v1/user":{"get":{"tags":["sber-smart-home"],"summary":"Get User","description":"Идентификатор пользователя в нашей системе по его Bearer-токену.\n\nСбер зовёт этот вебхук сразу после обмена code на токен и связывает\nполученный id со Сбер ID. Без него привязка не завершается: связывание\nпадает с findExternalUserID ... status code Not Found, даже когда токен\nуже успешно выдан.","operationId":"get_user_sber_v1_user_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sber/v1/devices":{"get":{"tags":["sber-smart-home"],"summary":"List Devices","operationId":"list_devices_sber_v1_devices_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sber/v1/query":{"post":{"tags":["sber-smart-home"],"summary":"Query Devices","operationId":"query_devices_sber_v1_query_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sber/v1/command":{"post":{"tags":["sber-smart-home"],"summary":"Command Devices","description":"Применяет состояния из запроса.\n\nОтвет по спецификации Сбера: успешные устройства в devices{}, неуспешные —\nв errors[] с кодом и сообщением на устройство. Если сорвалось всё, наружу\nвсё равно уходит 200 с заполненным errors[] — так Сбер покажет пользователю,\nчто именно не сработало, вместо общей ошибки интеграции.","operationId":"command_devices_sber_v1_command_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sber/v1/unlink":{"post":{"tags":["sber-smart-home"],"summary":"Unlink","description":"Пользователь отвязал аккаунт в приложении Салют — отзываем его токены.\n\nСбер отвязывает у себя независимо от нашего ответа, поэтому важно не\nпадать: наша задача — не оставить действующим токен, которым уже никто\nне пользуется. Тело запроса Сбер не присылает, ответ — пустой 200.","operationId":"unlink_sber_v1_unlink_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/salyut/v1/ping":{"get":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"Ping","description":"Проверка доступности. Авторизации быть не должно — Сбер пингует без\nпользовательского контекста, и 401 здесь означал бы для него, что\nинтеграция лежит.","operationId":"ping_salyut_v1_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/salyut/v1/user":{"get":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"Get User","description":"Идентификатор пользователя в нашей системе по его Bearer-токену.\n\nСбер зовёт этот вебхук сразу после обмена code на токен и связывает\nполученный id со Сбер ID. Без него привязка не завершается: связывание\nпадает с findExternalUserID ... status code Not Found, даже когда токен\nуже успешно выдан.","operationId":"get_user_salyut_v1_user_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/salyut/v1/devices":{"get":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"List Devices","operationId":"list_devices_salyut_v1_devices_get","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/salyut/v1/query":{"post":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"Query Devices","operationId":"query_devices_salyut_v1_query_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/salyut/v1/command":{"post":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"Command Devices","description":"Применяет состояния из запроса.\n\nОтвет по спецификации Сбера: успешные устройства в devices{}, неуспешные —\nв errors[] с кодом и сообщением на устройство. Если сорвалось всё, наружу\nвсё равно уходит 200 с заполненным errors[] — так Сбер покажет пользователю,\nчто именно не сработало, вместо общей ошибки интеграции.","operationId":"command_devices_salyut_v1_command_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/salyut/v1/unlink":{"post":{"tags":["salyut-smart-home","sber-smart-home"],"summary":"Unlink","description":"Пользователь отвязал аккаунт в приложении Салют — отзываем его токены.\n\nСбер отвязывает у себя независимо от нашего ответа, поэтому важно не\nпадать: наша задача — не оставить действующим токен, которым уже никто\nне пользуется. Тело запроса Сбер не присылает, ответ — пустой 200.","operationId":"unlink_salyut_v1_unlink_post","parameters":[{"name":"X-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnnouncementPublicOut":{"properties":{"id":{"type":"integer","title":"Id"},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["id","text","created_at","expires_at"],"title":"AnnouncementPublicOut","description":"CCB-D: что юзер видит в плашке-баннере проекта."},"Body_authorize_post_oauth_authorize_post":{"properties":{"response_type":{"type":"string","title":"Response Type"},"client_id":{"type":"string","title":"Client Id"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"scope":{"type":"string","title":"Scope","default":"smart_home"},"state":{"type":"string","title":"State","default":""},"consent_action":{"type":"string","title":"Consent Action","default":"deny"}},"type":"object","required":["response_type","client_id","redirect_uri"],"title":"Body_authorize_post_oauth_authorize_post"},"Body_token_endpoint_oauth_token_post":{"properties":{"grant_type":{"type":"string","title":"Grant Type"},"client_id":{"type":"string","title":"Client Id","default":""},"client_secret":{"type":"string","title":"Client Secret","default":""},"code":{"type":"string","title":"Code","default":""},"redirect_uri":{"type":"string","title":"Redirect Uri","default":""},"refresh_token":{"type":"string","title":"Refresh Token","default":""}},"type":"object","required":["grant_type"],"title":"Body_token_endpoint_oauth_token_post"},"ChangePasswordIn":{"properties":{"old_password":{"type":"string","title":"Old Password"},"new_password":{"type":"string","maxLength":72,"minLength":6,"title":"New Password"}},"type":"object","required":["old_password","new_password"],"title":"ChangePasswordIn","description":"Смена пароля: подтверждение старым + новый."},"CommandIn":{"properties":{"type":{"type":"string","maxLength":40,"minLength":1,"title":"Type"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}},"type":"object","required":["type"],"title":"CommandIn","description":"Body для POST /devices/{id}/commands.\n\nИзвестные payload проверяет command endpoint перед постановкой в очередь.\nУчастникам доступны только команды разрешённых entities; команды всей\nплаты и расширяемые типы доступны администраторам проекта."},"ContactSeedIn":{"properties":{"hash":{"type":"string","maxLength":8,"minLength":8,"title":"Hash"},"sender_email":{"type":"string","format":"email","title":"Sender Email"},"message":{"type":"string","maxLength":10000,"minLength":1,"title":"Message"},"lang":{"type":"string","maxLength":8,"title":"Lang","default":"ru"},"ip_addr":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ip Addr"},"user_agent":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"User Agent"},"referer":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Referer"}},"type":"object","required":["hash","sender_email","message"],"title":"ContactSeedIn","description":"Payload от landing'a после успешной отправки email'ов.\n\nhash — landing's bin2hex(random_bytes(4)) → 8 hex UPPERCASE."},"ContactSeedOut":{"properties":{"ok":{"type":"boolean","title":"Ok"},"dialog_id":{"type":"integer","title":"Dialog Id"},"action":{"type":"string","title":"Action"}},"type":"object","required":["ok","dialog_id","action"],"title":"ContactSeedOut"},"DeleteAccountIn":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"DeleteAccountIn","description":"Подтверждение пароля перед удалением аккаунта. Тело DELETE /auth/me."},"DeviceCreatedOut":{"properties":{"id":{"type":"integer","title":"Id"},"project_id":{"type":"integer","title":"Project Id"},"uuid":{"type":"string","title":"Uuid"},"name":{"type":"string","title":"Name"},"device_type":{"type":"string","title":"Device Type"},"fw_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fw Version"},"last_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ip"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"last_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last State"},"cloud_interval_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cloud Interval Sec"},"disabled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Disabled At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"api_key":{"type":"string","title":"Api Key"}},"type":"object","required":["id","project_id","uuid","name","device_type","created_at","api_key"],"title":"DeviceCreatedOut","description":"Ответ на POST /devices и rotate-key — содержит plain api_key.\n\nПоказывается ОДИН РАЗ; пользователь обязан скопировать его в /config/cloud.json\nплаты. Если ключ потерян — POST /rotate-key создаст новый и инвалидирует старый."},"DeviceGroupIn":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"sort_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sort Order","default":0}},"type":"object","required":["name"],"title":"DeviceGroupIn"},"DeviceGroupOut":{"properties":{"id":{"type":"integer","title":"Id"},"project_id":{"type":"integer","title":"Project Id"},"name":{"type":"string","title":"Name"},"sort_order":{"type":"integer","title":"Sort Order"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"my_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"My Role"},"my_hidden":{"type":"boolean","title":"My Hidden","default":false}},"type":"object","required":["id","project_id","name","sort_order","created_at"],"title":"DeviceGroupOut"},"DeviceIn":{"properties":{"uuid":{"type":"string","maxLength":64,"minLength":8,"title":"Uuid","description":"UUID платы — копируется с её UI"},"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"device_type":{"type":"string","maxLength":40,"minLength":1,"title":"Device Type","default":"ctrl-board"}},"type":"object","required":["uuid","name"],"title":"DeviceIn","description":"Body при регистрации новой платы в проекте.\n\nUUID берётся с физической платы (показывается в UI / Settings → Устройство).\nCloud сам генерит api_key и возвращает в ответе ОДИН РАЗ."},"DeviceOut":{"properties":{"id":{"type":"integer","title":"Id"},"project_id":{"type":"integer","title":"Project Id"},"uuid":{"type":"string","title":"Uuid"},"name":{"type":"string","title":"Name"},"device_type":{"type":"string","title":"Device Type"},"fw_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fw Version"},"last_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ip"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"last_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last State"},"cloud_interval_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cloud Interval Sec"},"disabled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Disabled At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","project_id","uuid","name","device_type","created_at"],"title":"DeviceOut","description":"Стандартный shape — БЕЗ api_key. Plain ключ виден только при create/rotate."},"DeviceUpdateIn":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"device_type":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"title":"Device Type"},"uuid":{"anyOf":[{"type":"string","maxLength":64,"minLength":8},{"type":"null"}],"title":"Uuid"},"disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Disabled"}},"type":"object","title":"DeviceUpdateIn","description":"PUT — меняем name/device_type/uuid. api_key неизменяем (только rotate).\n\nPhase 17: device.group_id убран — привязка к группам идёт через\n/api/v1/projects/{pid}/groups/{gid}/entities, не через PUT device.\n\nPhase OTA-FS recovery (2026-05-13): UUID стал editable, потому что\nFS-OTA с прошивок < 0.4.3 wipe'ает /config/device_config.json,\nплата генерит новый UUID, и единственный путь восстановления был\ndelete+create. Теперь можно просто отредактировать существующую\nзапись и подставить новый UUID."},"EntityVoiceIn":{"properties":{"voice_visible":{"type":"boolean","title":"Voice Visible","default":true},"voice_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Type"},"voice_name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Voice Name"},"voice_room":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Voice Room"}},"type":"object","title":"EntityVoiceIn"},"EntityVoiceOut":{"properties":{"device_id":{"type":"integer","title":"Device Id"},"device_name":{"type":"string","title":"Device Name"},"entity_kind":{"type":"string","title":"Entity Kind"},"entity_id":{"type":"integer","title":"Entity Id"},"entity_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"voice_visible":{"type":"boolean","title":"Voice Visible","default":true},"voice_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Type"},"voice_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Name"},"voice_room":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Room"},"group_names":{"items":{"type":"string"},"type":"array","title":"Group Names","default":[]}},"type":"object","required":["device_id","device_name","entity_kind","entity_id"],"title":"EntityVoiceOut","description":"Один entity юзера с текущими voice-настройками.\n\nЕсли override нет (DeviceEntityVoice отсутствует) — поля == дефолтам:\nvoice_visible=True, voice_type=None (default switch для relay), voice_name/voice_room None.\n\ngroup_names (fix #CCB-24) — список имён групп где состоит entity,\nотсортированный по DeviceGroup.sort_order. UI использует первую группу\nкак placeholder для voice_room; backend mapper в Yandex отдаёт первую\nгруппу как room при пустом voice_room override."},"GroupEntitiesReplaceIn":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/GroupEntityRef"},"type":"array","title":"Entities"}},"type":"object","required":["entities"],"title":"GroupEntitiesReplaceIn","description":"Bulk replace всего набора entities группы — удобно для UI с чекбоксами."},"GroupEntityOut":{"properties":{"id":{"type":"integer","title":"Id"},"group_id":{"type":"integer","title":"Group Id"},"device_id":{"type":"integer","title":"Device Id"},"entity_id":{"type":"integer","title":"Entity Id"},"entity_kind":{"type":"string","title":"Entity Kind"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","group_id","device_id","entity_id","entity_kind","created_at"],"title":"GroupEntityOut"},"GroupEntityRef":{"properties":{"device_id":{"type":"integer","title":"Device Id"},"entity_id":{"type":"integer","title":"Entity Id"},"entity_kind":{"type":"string","enum":["relay","sensor"],"title":"Entity Kind"}},"type":"object","required":["device_id","entity_id","entity_kind"],"title":"GroupEntityRef","description":"Минимальная ссылка на реле/сенсор для PUT replace."},"GroupMemberAddIn":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","enum":["admin","member","viewer"],"title":"Role","default":"member"}},"type":"object","required":["email"],"title":"GroupMemberAddIn","description":"Добавить участника по email с ролью в этой группе.\nЕсли такого user'а нет в системе — нужен invite-flow (POST /invites)."},"GroupMemberOut":{"properties":{"user_id":{"type":"integer","title":"User Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"}},"type":"object","required":["user_id","email","role","joined_at"],"title":"GroupMemberOut","description":"Participant группы с email и ролью для UI."},"GroupMemberUpdateIn":{"properties":{"role":{"type":"string","enum":["admin","member","viewer"],"title":"Role"}},"type":"object","required":["role"],"title":"GroupMemberUpdateIn","description":"PUT — сменить роль участника в группе."},"GroupVisibilityIn":{"properties":{"hidden":{"type":"boolean","title":"Hidden"}},"type":"object","required":["hidden"],"title":"GroupVisibilityIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeartbeatIn":{"properties":{"response_nonce":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"null"}],"title":"Response Nonce"},"fw_version":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Fw Version"},"ip":{"anyOf":[{"type":"string","maxLength":45},{"type":"null"}],"title":"Ip"},"uptime_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Uptime Sec"},"interval_sec":{"anyOf":[{"type":"integer","maximum":86400.0,"minimum":1.0},{"type":"null"}],"title":"Interval Sec"},"state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"State","description":"snapshot устройств/реле/сенсоров"},"tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tasks"},"applied_command_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Applied Command Ids"}},"type":"object","title":"HeartbeatIn"},"HeartbeatOut":{"properties":{"server_ts":{"type":"integer","title":"Server Ts"},"pending_commands":{"items":{"$ref":"#/components/schemas/cloud_service__schemas__heartbeat__CommandOut"},"type":"array","title":"Pending Commands","default":[]}},"type":"object","required":["server_ts"],"title":"HeartbeatOut","description":"Ответ платe на heartbeat — список накопленных команд + сервер-ts.\n\nserver_ts полезен платe для коррекции часов (если NTP недоступен, а cloud есть)."},"InviteIn":{"properties":{"role":{"type":"string","enum":["admin","member","viewer"],"title":"Role","default":"member"},"expires_in_hours":{"type":"integer","title":"Expires In Hours","default":168},"group_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Group Ids"}},"type":"object","title":"InviteIn"},"InviteOut":{"properties":{"id":{"type":"integer","title":"Id"},"project_id":{"type":"integer","title":"Project Id"},"group_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Group Id"},"group_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Group Ids"},"token":{"type":"string","title":"Token"},"role":{"type":"string","title":"Role"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Used At"}},"type":"object","required":["id","project_id","token","role","created_at"],"title":"InviteOut","description":"Ответ на POST /invites — содержит токен ОДИН РАЗ.\n\nOwner копирует ссылку и отправляет приглашённому. Сам токен в БД храним\nнехешированный — для preview /invites/{token} он нужен в plain виде."},"InvitePreviewOut":{"properties":{"project_id":{"type":"integer","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"role":{"type":"string","title":"Role"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"group_names":{"items":{"type":"string"},"type":"array","title":"Group Names","default":[]}},"type":"object","required":["project_id","project_name","role"],"title":"InvitePreviewOut","description":"Preview для приёмника приглашения (без auth) — минимум, чтобы показать\n«Вы приглашены в проект X с ролью Y»."},"LoginStartIn":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginStartIn"},"MemberGroupRoleOut":{"properties":{"group_id":{"type":"integer","title":"Group Id"},"group_name":{"type":"string","title":"Group Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["group_id","group_name","role"],"title":"MemberGroupRoleOut","description":"Группа + роль user'а в ней — для отображения «admin в G1, G2»."},"MemberOut":{"properties":{"user_id":{"type":"integer","title":"User Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"project_wide":{"type":"boolean","title":"Project Wide","default":false},"is_default":{"type":"boolean","title":"Is Default"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"},"group_roles":{"items":{"$ref":"#/components/schemas/MemberGroupRoleOut"},"type":"array","title":"Group Roles","default":[]}},"type":"object","required":["user_id","email","role","is_default","joined_at"],"title":"MemberOut"},"MemberUpdateIn":{"properties":{"role":{"type":"string","enum":["admin","member","viewer"],"title":"Role"},"project_wide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Project Wide"}},"type":"object","required":["role"],"title":"MemberUpdateIn"},"NotificationSettingsIn":{"properties":{"notify_notes":{"type":"boolean","title":"Notify Notes"}},"type":"object","required":["notify_notes"],"title":"NotificationSettingsIn","description":"Apply: PUT /auth/me/notifications. Пока единственный флаг — notify_notes."},"ProjectIn":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"is_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Default"}},"type":"object","required":["name"],"title":"ProjectIn"},"ProjectNoteIn":{"properties":{"text":{"type":"string","maxLength":1000,"minLength":1,"title":"Text"}},"type":"object","required":["text"],"title":"ProjectNoteIn"},"ProjectNoteOut":{"properties":{"id":{"type":"integer","title":"Id"},"user_id":{"type":"integer","title":"User Id"},"author_email":{"type":"string","title":"Author Email"},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"can_delete":{"type":"boolean","title":"Can Delete"},"is_admin_message":{"type":"boolean","title":"Is Admin Message","default":false},"is_to_admin":{"type":"boolean","title":"Is To Admin","default":false},"dialog_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dialog State"}},"type":"object","required":["id","user_id","author_email","text","created_at","can_delete"],"title":"ProjectNoteOut"},"ProjectOut":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_default":{"type":"boolean","title":"Is Default"},"role":{"type":"string","title":"Role"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","is_default","role","created_at"],"title":"ProjectOut"},"ProviderStatus":{"properties":{"provider":{"type":"string","title":"Provider"},"enabled":{"type":"boolean","title":"Enabled"},"linked":{"type":"boolean","title":"Linked"},"linked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Linked At"}},"type":"object","required":["provider","enabled","linked"],"title":"ProviderStatus"},"RefreshIn":{"properties":{"refresh_token":{"type":"string","maxLength":128,"minLength":16,"title":"Refresh Token"}},"type":"object","required":["refresh_token"],"title":"RefreshIn","description":"POST /auth/refresh body — обмениваем refresh на новую пару access+refresh."},"RegisterStartIn":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","maxLength":72,"minLength":6,"title":"Password"}},"type":"object","required":["email","password"],"title":"RegisterStartIn"},"StartOut":{"properties":{"sent":{"type":"boolean","title":"Sent","default":true},"resend_after_sec":{"type":"integer","title":"Resend After Sec"}},"type":"object","required":["resend_after_sec"],"title":"StartOut","description":"202: код отправлен. resend_after_sec — сколько секунд до следующего /start."},"TokenOut":{"properties":{"access_token":{"type":"string","title":"Access Token"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"default_project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Default Project Id"}},"type":"object","required":["access_token"],"title":"TokenOut"},"UserOut":{"properties":{"id":{"type":"integer","title":"Id"},"email":{"type":"string","title":"Email"},"default_project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Default Project Id"},"notify_notes":{"type":"boolean","title":"Notify Notes","default":true}},"type":"object","required":["id","email"],"title":"UserOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyCodeIn":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"code":{"type":"string","maxLength":6,"minLength":6,"pattern":"^\\d{6}$","title":"Code"}},"type":"object","required":["email","code"],"title":"VerifyCodeIn","description":"Подтверждение по 6-значному коду из письма (общая схема для register/login)."},"VerifyTokenIn":{"properties":{"token":{"type":"string","maxLength":128,"minLength":16,"title":"Token"}},"type":"object","required":["token"],"title":"VerifyTokenIn","description":"Подтверждение по long-token из clickable-ссылки в письме."},"_AclRequest":{"properties":{"clientid":{"type":"string","title":"Clientid","default":""},"username":{"type":"string","title":"Username","default":""},"topic":{"type":"string","title":"Topic","default":""},"action":{"type":"string","title":"Action","default":""}},"type":"object","title":"_AclRequest","description":"То что EMQX шлёт в /api/v1/mqtt/acl на каждый pub/sub."},"_AuthRequest":{"properties":{"clientid":{"type":"string","title":"Clientid","default":""},"username":{"type":"string","title":"Username","default":""},"password":{"type":"string","title":"Password","default":""}},"type":"object","title":"_AuthRequest","description":"То что EMQX шлёт в /api/v1/mqtt/auth.\n\nШаблон тела сконфигурирован в docker-compose env:\n    BODY = '{\"clientid\":\"$${clientid}\",\"username\":\"$${username}\",\"password\":\"$${password}\"}'"},"_Decision":{"properties":{"result":{"type":"string","enum":["allow","deny"],"title":"Result"}},"type":"object","required":["result"],"title":"_Decision","description":"Ответ для EMQX. `\"allow\"` пропускает, `\"deny\"` отказывает."},"cloud_service__schemas__command__CommandOut":{"properties":{"id":{"type":"integer","title":"Id"},"device_id":{"type":"integer","title":"Device Id"},"command_type":{"type":"string","title":"Command Type"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"},"acked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Acked At"}},"type":"object","required":["id","device_id","command_type","created_at","expires_at"],"title":"CommandOut"},"cloud_service__schemas__heartbeat__CommandOut":{"properties":{"id":{"type":"integer","title":"Id"},"type":{"type":"string","title":"Type"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}},"type":"object","required":["id","type"],"title":"CommandOut"}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/auth/login/start"}}}}}}