---
title: "Открыть загрузку документа согласия формы"
method: POST
path: "/api/v1/crm/web-forms/{id}/consent-file/upload-sessions"
tags: ["CRM leads"]
---

# Открыть загрузку документа согласия формы

`POST /api/v1/crm/web-forms/{id}/consent-file/upload-sessions`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/web-forms/{id}/consent-file/upload-sessions`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Документ согласия на обработку персональных данных (политика, текст согласия) — файл любого формата до 25 МБ. Байты кладутся прямо в хранилище кабинета по подписанному адресу, мимо API: post — один multipart POST на upload.url с полями upload.fields и файлом последним полем upload.file_field; parts — PUT каждой части на upload.direct_urls; api — хранилище подписывать не умеет, байты идут PUT на upload.url этого API с авторизацией. Затем crmFinishWebFormUploadSession проверяет файл антивирусом и ставит его документом согласия формы вместо прежнего.

## Request body

- TransferUploadRequest: Заявка на сессию загрузки файла по подписанному адресу.
  - `name` string, required: Имя файла с расширением
  - `mime_type` string: Тип содержимого; по умолчанию application/octet-stream
  - `size_bytes` integer, required: Точный размер файла в байтах
  - `sha256` string: Необязательная контрольная сумма SHA-256 строчными шестнадцатеричными знаками

## Response `201`

Сессия и адрес для байтов

- TransferSession: Сессия загрузки файла по подписанному адресу хранилища. Ключи хранилища наружу не отдаются.
  - `id` string, uuid, required
  - `owner_type` string, required
  - `owner_id` string
  - `name` string, required
  - `mime_type` string, required
  - `size_bytes` integer, required
  - `sha256` string
  - `attributes` object
  - `status` 'pending' | 'processing' | 'attached' | 'failed' | 'expired', required
  - `failure` 'infected' | 'size' | 'checksum' | 'storage' | 'owner' | 'aborted' | 'expired'
  - `failure_detail` string
  - `scan_status` 'pending' | 'clean' | 'infected' | 'skipped'
  - `scan_verdict` string
  - `published_ref` string: Номер строки, заведённой по файлу; у почты — id загрузки для upload_ids
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time
  - `upload` TransferInstructions: Как передать байты. Выдаётся один раз, при открытии сессии.
    - `mode` 'post' | 'parts' | 'api', required: post — один multipart POST; parts — PUT каждой части; api — PUT через этот API с авторизацией
    - `url` string
    - `method` string
    - `fields` object: Поля формы для POST; файл идёт после них последним полем
    - `file_field` string: Имя поля формы для файла
    - `headers` object
    - `part_bytes` integer
    - `part_count` integer
    - `direct_urls` object: Подписанный адрес каждой части по её номеру, начиная с 1
    - `requires_authorization` boolean, required: true — адрес требует токен API, агенту по MCP этот путь недоступен
    - `max_bytes` integer, required
    - `expires_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)