assessment360.tag.update

Scope: assessment360

Кто может вызывать: Авторизованный пользователь (свои теги); при assessmentId — ещё право на теги карточки. См. Права доступа

Обновляет тег текущего пользователя: имя и/или привязку к карточке оценки.

HTTP: POST

Побочные эффекты: Изменяет состояние данных модуля assessment360.

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

Параметр Тип Обяз. Описание
id int да ID записи тега
tagName string да Новое имя тега
assessmentId int нет ID карточки оценки (если не передан — сохраняется текущая привязка)

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

Ответ возвращается в конверте модуля: result.result, result.next, result.error, total.

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
VALIDATION_ERROR Ошибка валидации входных параметров
TAG_NOT_FOUND Тег не найден или не принадлежит текущему пользователю
PERMISSION_DENIED Недостаточно прав на управление тегами оценки
TAG_ALREADY_EXISTS Тег с таким именем уже есть у текущего пользователя для данного assessmentId

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.tag.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "id": 17,
          "tagName": "Q3-2026-updated",
          "assessmentId": 331
        }'
        

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

{
          "result": {
            "result": {
              "id": 17,
              "tagName": "Q3-2026-updated",
              "assessmentId": 331,
              "userId": 1
            },
            "next": null,
            "error": null
          },
          "total": 0
        }
        

См. также

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