метод REST scope: lists

lists.element.update

Изменить элемент универсального списка

Кто может выполнять: пользователь с правом «Изменение» для нужного списка

Описание

Метод lists.element.update обновляет элемент списка.

Метод перезаписывает элемент полностью. Поля, значения которых не передаются, будут очищаться

Параметры

IBLOCK_TYPE_ID string обязательный

Идентификатор типа инфоблока.

Стандартные типы:
- lists — универсальные списки
- bitrix_processes — процессы
- lists_socnet — списки групп

В коробочной версии можно также указать идентификатор произвольного существующего типа инфоблоков. IBLOCK_ID или IBLOCK_CODE должен указывать на инфоблок этого типа. Доступ к операции определяется стандартными правами пользователя на инфоблок, раздел или элемент

IBLOCK_ID integer обязательный

Идентификатор инфоблока.

Идентификатор можно получить с помощью метода lists.get

IBLOCK_CODE string обязательный

Cимвольный код инфоблока.

Код можно получить с помощью метода lists.get

Необходимо указать хотя бы один из параметров: IBLOCK_ID или IBLOCK_CODE

ELEMENT_ID integer обязательный

Идентификатор элемента.

Идентификатор можно получить с помощью метода lists.element.get

ELEMENT_CODE string обязательный

Символьный код элемента.

Код можно получить с помощью метода lists.element.get

Необходимо указать хотя бы один из параметров: ELEMENT_ID или ELEMENT_CODE

FIELDS array обязательный

Массив полей.

Подробное описание

Параметр FIELDS

NAME string обязательный

Название элемента

PROPERTY_PropertyId необязательный

Пользовательские свойства.

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

Чтобы передать значение в поле типа Файл укажите:
- для типа Файл — base64 или массив с названием и base64
- для типа Файл (Диск) — идентификатор файла с Диска

Подробнее о работе с файлами в статье Как обновить и удалить файлы

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":47,"ELEMENT_ID":6999,"FIELDS":{"NAME":"Тестовый элемент (обновлен)","PROPERTY_951":["1269"]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1763658078,
        "finish": 1763658078.767221,
        "duration": 0.7672209739685059,
        "processing": 0,
        "date_start": "2025-11-19T15:01:18+03:00",
        "date_finish": "2025-11-19T15:01:18+03:00",
        "operating_reset_at": 1763658678,
        "operating": 0.1465599536895752
    }
}

Возвращаемые данные

result boolean

Возвращает true, если элемент обновлен успешно

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"ERROR_ELEMENT_FIELD_VALUE",
    "error_description":"Writing file values by ID is not supported"
}
Код Описание Значение
ERROR_REQUIRED_PARAMETERS_MISSING Required parameter X is missing Обязательный параметр не передан
ERROR_IBLOCK_NOT_FOUND Iblock not found Инфоблок не найден
ERROR_ELEMENT_NOT_FOUND Element not found Элемент с таким ID/CODE не найден
ERROR_UPDATE_ELEMENT Ошибка при обновлении элемента
ERROR_ELEMENT_FIELD_VALUE Writing file values by ID is not supported Ошибка валидации значения поля
ACCESS_DENIED Access denied Недостаточно прав для обновления элемента

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.