метод REST scope: entity

entity.item.update

Обновить элемент хранилища

Кто может выполнять: пользователь с уровнем права W (запись) или X (управление) на хранилище данных

Описание

Метод работает только в контексте приложения.

Параметры

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

Идентификатор хранилища данных приложения. Используйте значение, которое указали при создании хранилища.

Получить идентификатор можно методом entity.get

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

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

Получить идентификатор элемента хранилища можно методом entity.item.get

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

Новое название элемента хранилища

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

Значения свойств элемента в формате {"КОД_СВОЙСТВА": значение}.

Список доступных кодов свойств можно получить методом entity.item.property.get.

Для свойств типа файл используется формат из статьи Как загрузить файлы

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

Идентификатор раздела хранилища

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

Дата начала активности элемента

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

Дата окончания активности элемента

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

Картинка анонса элемента. Формат файла — в статье Как загрузить файлы.

Если передать false, картинка будет удалена

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

Детальная картинка элемента. Формат файла — в статье Как загрузить файлы.

Если передать false, картинка будет удалена

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

Пользовательские поля элемента UF_*.

Передаются отдельными параметрами в формате "UF_КОД": значение, например: "UF_CRM_1_COLOR": "red", "UF_CRM_1_SIZE": 42

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ENTITY":"dish","ID":2333,"NAME":"Hello, updated world!","PROPERTY_VALUES":{"test":33,"test1":44},"SECTION":219,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/entity.item.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1774437094,
        "finish": 1774437094.470878,
        "duration": 0.47087788581848145,
        "processing": 0,
        "date_start": "2026-03-25T14:11:34+03:00",
        "date_finish": "2026-03-25T14:11:34+03:00",
        "operating_reset_at": 1774437694,
        "operating": 0
    }
}

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

result boolean

Результат обновления элемента (true — успешно)

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ITEM_NOT_FOUND",
    "error_description": "Item not found"
}
Код Описание Значение
ERROR_ARGUMENT Argument 'ENTITY' is null or empty Параметр ENTITY не передан или пустой после очистки
ERROR_ARGUMENT Entity code is too long. Max length is N characters. Слишком длинное значение ENTITY
ERROR_ARGUMENT Argument 'ID' is null or empty Параметр ID не передан или <= 0
ERROR_ARGUMENT Ошибки валидатора полей элемента Переданы невалидные входные поля
ERROR_ENTITY_NOT_FOUND Entity not found Хранилище с переданным ENTITY не найдено
ERROR_ITEM_NOT_FOUND Item not found Элемент с переданным ID не найден в хранилище
ACCESS_DENIED Access denied! Недостаточно прав для обновления элемента
ACCESS_DENIED Access denied! Application context required Нет контекста приложения (clientId)
ERROR_CORE Internal error updating entity item. Try updating again. Внутренняя ошибка при обновлении элемента

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

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