assessment360.tag.add

Scope: assessment360

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

Создаёт тег текущего пользователя. Опционально привязывает тег к карточке оценки.

HTTP: POST

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

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

Параметр Тип Обяз. Описание
tagName string да Имя тега (алиас: newTag)
assessmentId int нет ID карточки оценки для привязки тега

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

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

При успешном создании — { "id": <int>, "success": true }.

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

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

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

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

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

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

{
          "result": {
            "result": {
              "id": 17,
              "success": true
            },
            "next": null,
            "error": null
          },
          "total": 0
        }

См. также

Предыдущая
assessment360.tag.get
Следующая
assessment360.tag.update