Перейти к основному содержанию
PATCH
Python

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

sessionId
string<uuid>
обязательно

UUID сессии Верификации бизнеса (KYB). Он должен принадлежать приложению используемого API-ключа.

Пример:

"33333333-4444-5555-6666-777777777777"

draftId
string<uuid>
обязательно

UUID черновика стороны (draft_id, возвращённый при его создании).

Пример:

"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d"

Параметры запроса

node_id
string

Узел сценария для шага KYB. Требуется, только если в сценарии несколько KYB-узлов; по умолчанию Didit использует собственный узел сессии.

Тело

application/json

Любое подмножество полей стороны. Изменение объединяется с сохранённым черновиком, и объединённая сторона валидируется целиком, поэтому черновик, который можно было отправить до изменения, можно будет отправить и после него.

entity_type
enum<string>

Является ли сторона физическим лицом или компанией.

Доступные опции:
person,
company
full_name
string

Полное имя человека. Передайте его либо first_name и last_name.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

Роль стороны. Взаимозаменяема с roles; если переданы оба параметра, они объединяются.

Доступные опции:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

Каждая роль, которую занимает сторона. У физического лица должна быть как минимум одна роль (здесь или в role).

Доступные опции:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

Должность лица.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

Название участника компании. Обязательно, если entity_type имеет значение company.

Maximum string length: 255
registration_number
string

Регистрационный номер участника компании.

Maximum string length: 100
email
string<email>

Куда отправляется ссылка на верификацию. Обязательно, если стороне необходимо пройти верификацию, что зависит от настроек ролей и порогов структуры владения в сценарии.

ownership_percent
number | null

Доля в компании, принадлежащая стороне.

nationality
string

Гражданство физического лица или страна регистрации компании. Обязательно для каждой стороны.

Maximum string length: 100
phone_number
string
Maximum string length: 32
custom_fields
object

Дополнительные поля, определённые сценарием.

skip_verification
boolean
по умолчанию:false

Запросить пропуск верификации этой стороны. Учитывается только тогда, когда роль стороны позволяет пропуск в настройках «Ключевые лица» сценария.

Ответ

Черновик обновлён.

draft_id
string<uuid>
обязательно
created_at
string<date-time>
обязательно
updated_at
string<date-time>
обязательно
party
object
обязательно
Последнее изменение 7 ноября 2026 г.