goalsmanagement.goalitem.delete

Scope: goalsmanagement

Кто может вызывать: Сотрудник / руководитель / админ (иначе ACCESS_DENIED). Подробнее: Права доступа

Подтверждение: без confirm=true — CONFIRM_REQUIRED

Удалить цели карточки по ID (нужен confirm=true)

HTTP: POST

Побочные эффекты: удаление целей (каскад при confirm)

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

Параметр Тип Обяз. Описание
cardId int да ID карточки
goalIds array да Массив ID целей
confirm bool да Явное подтверждение (true)

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

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

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Некорректные или неполные параметры
CONFIRM_REQUIRED Требуется явное подтверждение (confirm=true)
ACCESS_DENIED Нет прав на операцию (общий запрет)
INTERNAL_ERROR Внутренняя ошибка сервера

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/goalsmanagement.goalitem.delete.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          --data '{
          "cardId": 501,
          "goalIds": [
            1001
          ],
          "confirm": true
        }'

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

{
          "result": {
            "result": {
              "cardId": 501,
              "deletedIds": [
                1001
              ]
            },
            "error": null
          }
        }

См. также

Предыдущая
Обзор раздела
Следующая
goalsmanagement.goalitem.list