assessment360.assessment.tags.update

Scope: assessment360

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

Обновляет набор тегов карточки оценки.

HTTP: POST

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

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

Параметр Тип Обяз. Описание
id int да Идентификатор карточки оценки (допустим алиас assessmentId)
tagIds string[] нет Список имён тегов (строки), не числовых ID из БД. Алиас: tags
newTag string нет Имя нового тега — создаётся и добавляется к списку (если ещё не присутствует)

Параметр tagIds задаёт полный целевой набор имён тегов карточки. Значение newTag дополнительно добавляется к этому списку.

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

Объект { tags } — актуальный массив тегов после обновления. Ответ в конверте модуля: result.result, result.error.

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

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.assessment.tags.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "id": 214,
          "tagIds": [
            "rest-test-draft",
            "черновик-rest"
          ],
          "newTag": "Q3-2026"
        }'

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

{
          "result": {
            "result": {
              "tags": ["rest-test-draft", "черновик-rest", "Q3-2026"]
            },
            "error": null
          }
        }

См. также

Предыдущая
assessment360.assessment.tags.get
Следующая
Обзор раздела