goalsmanagement.goal.update

Scope: goalsmanagement

Кто может вызывать: ModuleUser::canAddGoal(). Подробнее: Права доступа

Обновить элемент каталога целей

HTTP: POST

Побочные эффекты: обновляет элемент ИБ

Параметры метода

Параметр Тип Обяз. Описание
id int да ID цели
name string да Название
typeId int да ID типа из goal.type.list (также type / typeGoals)
active bool нет Активность
sort int нет Сортировка
weightGoals mixed нет Вес
canCascade bool|string нет Каскад
weightStep mixed нет Шаг веса
maxPercent mixed нет Макс. процент
percentStep mixed нет Шаг процента
color string нет Цвет
hintText string нет Подсказка
hintTextPercent string нет Подсказка по проценту
access array нет Список доступа

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

Ответ в конверте модуля: result.result — обновлённая цель; result.error. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.

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

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Некорректные или неполные параметры
GOAL_NOT_FOUND Цель не найдена
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/goalsmanagement.goal.update.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          --data '{
          "id": 101,
          "name": "Увеличить выручку отдела",
          "typeId": 2,
          "weightGoals": 40,
          "maxPercent": 120
        }'
        

Пример ответа

{
          "result": {
            "result": {
              "id": 101,
              "active": true,
              "name": "Увеличить выручку отдела",
              "type": "strategy",
              "weightGoals": 40,
              "weightStep": 5,
              "maxPercent": 120,
              "percentStep": 5,
              "sort": 100,
              "canCascade": true,
              "color": "#2FC6F6",
              "dateCreate": "2026-01-10 09:15:00",
              "timestampX": "2026-07-15 14:30:00",
              "createdBy": 15,
              "modifiedBy": 15,
              "isUse": true
            },
            "error": null
          }
        }
        

См. также

Предыдущая
Следующая