# Создать приглашение

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Создать приглашение

`POST /api/v1/security/invites`

**Авторизация:** dpop

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

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

**Тело запроса** (`application/json`, обязательное): CreateInviteBody
- `email`: string — Email приглашаемого; без email создаётся ссылка-приглашение
- `role`: "admin" | "user", обязательное — Роль в команде после принятия приглашения
- `sendEmail`: boolean — Отправить письмо с приглашением на указанный email

**Ответы**

- `200` — Приглашение создано (`application/json`, CreateInviteResponse)
  - `invite`: InviteSummary, обязательное
    - `createdAt`: string (date-time), обязательное — Когда создано, ISO 8601
    - `email`: string, nullable, обязательное — Email приглашённого; null — приглашение по ссылке без привязки к email
    - `expiresAt`: string (date-time), обязательное — Срок действия, ISO 8601
    - `id`: string, обязательное — Идентификатор приглашения
    - `role`: string, обязательное — Роль после принятия: admin или user
  - `inviteLink`: string (uri), обязательное — Ссылка-приглашение для передачи пользователю
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)
- `429` — Превышен лимит запросов, повторите через Retry-After секунд (`application/problem+json`, ProblemDetails)

    </>
  );
}