метод REST scope: entity

entity.item.property.update

Изменить свойство элементов хранилища

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

Описание

Метод entity.item.property.update изменяет свойство элементов хранилища данных приложения.

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

Параметры

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

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

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

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

Код существующего свойства, которое нужно изменить.

Получить код свойства можно методом entity.item.property.get

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

Новый код свойства.

Разрешены символы a-z, A-Z, 0-9, _

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

Новое название свойства

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

Новый тип свойства:
- S — строка
- N — число

Изменить тип свойства на F (файл) нельзя — метод вернет ошибку

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

Индекс сортировки свойства

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ENTITY":"dish","PROPERTY":"new_prop","PROPERTY_NEW":"updated_prop","NAME":"Обновленное свойство","SORT":200,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/entity.item.property.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1774442553,
        "finish": 1774442553.149827,
        "duration": 0.1498270034790039,
        "processing": 0,
        "date_start": "2026-03-25T15:42:33+03:00",
        "date_finish": "2026-03-25T15:42:33+03:00",
        "operating_reset_at": 1774443153,
        "operating": 0
    }
}

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

result boolean

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

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_PROPERTY_NOT_FOUND",
    "error_description": "Property 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 Wrong entity item property type Передан недопустимый тип TYPE
ERROR_ARGUMENT Cannot change property type to File Попытка изменить тип свойства на F
ERROR_ENTITY_NOT_FOUND Entity not found Хранилище с переданным ENTITY не найдено
ERROR_PROPERTY_NOT_FOUND Property not found Свойство с переданным PROPERTY не найдено
ERROR_PROPERTY_ALREADY_EXISTS Property <PROPERTY_NEW> already exists Свойство с кодом PROPERTY_NEW уже существует
ACCESS_DENIED Access denied! Недостаточно прав для изменения свойства
ACCESS_DENIED Access denied! Application context required Нет контекста приложения (clientId)
ERROR_CORE Internal error updating entity property. Try updating again. Внутренняя ошибка при обновлении свойства

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

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