# Запросить передачу владения командой

> Владелец подтверждает действие паролем или кодом 2FA. Владение переходит, когда участник примет запрос; до этого предыдущий запрос команды отменяется новым.

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Запросить передачу владения командой

`POST /api/v1/security/teams/current/ownership-transfer`

Владелец подтверждает действие паролем или кодом 2FA. Владение переходит, когда участник примет запрос; до этого предыдущий запрос команды отменяется новым.

**Авторизация:** dpop или oauth2: `security.teams:read`, `security.teams:write`

**Параметры**

| Имя | Где | Обязательный | Тип | Описание |
| --- | --- | --- | --- | --- |
| `idempotency-key` | header | нет | string | Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч |

**Тело запроса** (`application/json`, обязательное): RequestOwnershipTransferBody
- `password`: string — Текущий пароль владельца для подтверждения
- `toUserId`: string (uuid), обязательное — Участник команды, которому передаётся владение
- `totpCode`: string — Код 2FA или резервный код владельца вместо пароля

**Ответы**

- `200` — Запрос создан и ожидает принятия (`application/json`, OwnershipTransfer)
  - `createdAt`: string (date-time), обязательное — Когда создан, ISO 8601
  - `expiresAt`: string (date-time), обязательное — Срок действия запроса, ISO 8601
  - `fromUserId`: string (uuid), обязательное — Владелец, отправивший запрос
  - `id`: string (uuid), обязательное — Идентификатор запроса на передачу владения
  - `status`: "pending" | "accepted" | "declined" | "cancelled" | "expired", обязательное — Состояние: ожидает, принят, отклонён, отменён или истёк
  - `teamId`: string (uuid), обязательное — Команда
  - `toUserId`: string (uuid), обязательное — Участник, которому передаётся владение
  - `updatedAt`: string (date-time), обязательное — Когда изменён, ISO 8601
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)
- `404` — Ресурс не найден (`application/problem+json`, ProblemDetails)
- `409` — Конфликт с текущим состоянием ресурса (`application/problem+json`, ProblemDetails)
- `429` — Превышен лимит запросов, повторите через Retry-After секунд (`application/problem+json`, ProblemDetails)

    </>
  );
}