# Открыть доступ к шаблону по email

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Открыть доступ к шаблону по email

`POST /api/v1/smartdoc/documents/{id}/shares/by-email`

**Авторизация:** dpop или oauth2: `smartdoc:share`

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

| Имя | Где | Обязательный | Тип | Описание |
| --- | --- | --- | --- | --- |
| `id` | path | да | string | Идентификатор шаблона или папки |

**Тело запроса** (`application/json`, обязательное): ShareByEmailRequest
- `email`: string, обязательное — Email получателя; если аккаунта нет — создаётся приглашение
- `permission`: "viewer" | "commenter" | "editor", обязательное — Уровень доступа: viewer — чтение, commenter — комментирование, editor — редактирование

**Ответы**

- `200` — Доступ выдан либо создано приглашение (`application/json`, ShareByEmailResult)
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)

    </>
  );
}