ipr.action.update

Scope: ipr

Кто может вызывать: Пользователь с canEdit на родительском ИПР либо привилегированный (admin/hr). Подробнее: Модель доступа

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

HTTP: POST

Побочные эффекты: Изменяет элемент действия.

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

Параметр Тип Обяз. Описание
id int да ID действия
title string нет Название, 1..255 символов
description string нет Описание
deadline (алиас dateTo) string нет Плановая дата, YYYY-MM-DD; пустая строка снимает дедлайн
dateClosed string нет Дата закрытия, YYYY-MM-DD; пустая строка снимает. Только привилегированный или руководитель сотрудника
resourceId (алиас actId) int нет Новый связанный ресурс. Только привилегированный или руководитель сотрудника
resourceType (алиас type) string нет Новый XML_ID типа ресурса, см. ipr.action.type.list. Только привилегированный или руководитель сотрудника
eventId int нет Дата проведения мероприятия каталога (см. ipr.action.add); 0 — отвязать дату проведения. Нельзя вместе с deadline / dateTo; прошедшая дата проведения — только администратор. Дата проведения должна принадлежать мероприятию resourceId с типом events (с учётом переданных в этом же вызове значений). С eventId плановая дата (DATE_TO) записывается во времени даты проведения, в её часовом поясе (как в интерфейсе); deadline в ответе приходит только датой YYYY-MM-DD. Если resourceId / resourceType изменились, а eventId не передан, прежняя привязка к дате проведения сбрасывается (дата проведения относилась к прежнему мероприятию)

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

Полное действие — та же форма, что у ipr.action.get.

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Некорректные значения полей, неизвестный resourceType; eventId вместе с deadline или не для resourceType=events; reason = date_not_in_event — дата проведения не принадлежит мероприятию
NOT_FOUND Действие или родительский ИПР не найдены
PERMISSION_DENIED Родительский ИПР недоступен для редактирования; прошедшая дата проведения eventId не от администратора, попытка изменить dateClosed, resourceId или resourceType не привилегированным пользователем и не руководителем сотрудника (например, владельцем ИПР)
INTERNAL_ERROR Внутренняя ошибка сервера

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.action.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{"id": 12001, "dateClosed": "2026-09-20"}'

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

{
          "result": {
            "result": {
              "id": 12001,
              "dateClosed": "2026-09-20"
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

Предыдущая
ipr.action.add
Следующая
ipr.action.delete