Перейти к основному содержанию
PATCH
cURL
Используйте PATCH для частичных обновлений. Чтобы переименовать анкету, отправьте только title или description.
Чтобы обновить вопросы, отправьте полный нужный массив form_elements. Он заменит предыдущий список вопросов. Сохраните существующие вопросы, которые вы хотите оставить.
API v3 поддерживает только простые линейные анкеты. Он отклоняет graph, branches, next и условные правила. Ответ содержит questionnaire_id. При обновлении анкеты со статусом published API может создать новую версию. Сохраните возвращённый questionnaire_id и используйте его в сценариях, а не считайте, что id из URL по-прежнему указывает на последнюю версию.

Авторизации

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.

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

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

UUID конкретной версии обновляемой анкеты.

Тело

application/json

Обновить метаданные анкеты или заменить полный линейный список form_elements.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
status
enum<string>
Доступные опции:
draft,
published
form_elements
object[]

Если указано, полностью заменяет весь линейный список вопросов.

Minimum array length: 1

Ответ

Анкета обновлена. Тело содержит последнее состояние полученной версии — обновлённую на месте версию или вновь созданную опубликованную версию, если вы передали status: "published" для опубликованной строки (в этом случае questionnaire_id и version отличаются от тех, к которым применялся патч). Поле questionnaire_id в ответе представляет собой UUID конкретной версии; используйте questionnaire_group_id, если вам нужен неизменный идентификатор группы.

Полные сведения об анкете, возвращаемые из endpoint’ов GET, POST (создание) и PATCH (обновление).

questionnaire_id
string<uuid>

Уникальный идентификатор анкеты. Используйте этот id при ссылке на анкету из сценария или в последующих запросах на обновление/удаление.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
is_simple_questionnaire
boolean
graph
object

Структура графа с полем start_node и отображением nodes.

sections
object[]

Содержимое анкеты, сгруппированное по разделам (на основе графа).

questionnaire_group_id
string<uuid>

Постоянный идентификатор, объединяющий все версии одной и той же анкеты.

version
integer
status
enum<string>
Доступные опции:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

True, когда анкету всё ещё можно редактировать на месте (черновые версии).

Последнее изменение 7 ноября 2026 г.