Изменить триггер с помощью запроса к API

Запрос позволяет изменить триггер.

https://api.tracker.yandex.net/v3/queues/<id_очереди>/triggers/<id_триггера>?version=<текущая_версия_триггера>

Формат запроса

Перед выполнением запроса получите доступ к API.

Чтобы изменить триггер, используйте HTTP-запрос с методом PATCH. В теле запроса укажите параметры в формате JSON.

PATCH /v3/queues/<id_очереди>/triggers/<id_триггера>?version=<текущая_версия_триггера>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": "<имя_триггера>",
    "actions": [<параметры_действия_триггера>],
    "conditions": [<параметры_условия_триггера>]
}

Примеры

1. Триггер, срабатывающий при выполнении хотя бы одного из условий.
2. Изменить действие триггера.
3. Триггер, срабатывающий при выполнении группы условий.
4. Отключить триггер.
5. Переместить триггер в списке и активировать.

Пример 1: Изменить условия срабатывания и действие триггера. Триггер должен срабатывать при выполнении хотя бы одного из заданных условий.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 1.
• Меняется условие срабатывания триггера: текст комментария совпадает с фразой «Need info» или «Нужна информация».
• Действие триггера: переход задачи в статус «Требуется информация».

PATCH /v3/queues/DESIGN/triggers/16?version=1
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "actions": [
      { "type": "Transition",
          "status": {
             "key": "needInfo" 
          }
      }
  ],
  "conditions": [
      { "type": "Or",
           "conditions": [
               { "type": "CommentFullyMatchCondition", "word": "Need info" },
               { "type": "CommentFullyMatchCondition", "word": "Нужна информация" }
           ]
      }
  ]
}

Пример 2: Изменить действие триггера.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 2.
• Меняется действие триггера: создается чеклист, где указаны названия пунктов, исполнитель и дедлайн.

PATCH /v3/queues/DESIGN/triggers/16?version=2
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "actions": [
     { 
        "type": "CreateChecklist",
        "checklistItems": [
           {
              "text": "Сделать то",
              "assignee": "username",
              "deadline": {"date": "2025-05-23"}
           },
           {
              "text": "Сделать это",
              "assignee": "username",
              "deadline": {"date": "2025-05-23"}
           },
           {"text": "Отчитаться за все"}
        ]
     }
  ]
}

Пример 3: Изменить условия срабатывания и действие триггера. Триггер должен срабатывать при выполнении одной из групп условий.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 3.
• Меняется условие срабатывания триггера — триггер срабатывает, если выполняется одна из групп условий:
• • Текст комментария совпадает с фразой «Need info» и статус задачи равен В работе;
• • Текст комментария совпадает с фразой «No data» ;
• Меняется действие триггера: переход задачи в статус «Требуется информация».

PATCH /v3/queues/DESIGN/triggers/16?version=3
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
   "actions": [
       {
           "type": "Transition",
           "status": {
               "key": "needInfo"
           }
       }
   ],
   "conditions": [
       {
           "type": "Or",
           "conditions": [
               {
                   "type": "And",
                   "conditions": [
                       {
                           "ignoreCase": false,
                           "noMatchBefore": false,
                           "removeMarkup": false,
                           "type": "CommentFullyMatchCondition",
                           "word": "Need info"
                       },
                       {
                           "type": "FieldEquals",
                           "field": "status",
                           "value": "inProgress"
                       }
                   ]
               },
               {
                   "ignoreCase": false,
                   "noMatchBefore": false,
                   "removeMarkup": false,
                   "type": "CommentFullyMatchCondition",
                   "word": "No data"
               }
           ]
       }
   ]
}

Пример 4: Отключить триггер.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 4.
• Триггер деактивируется.

PATCH /v3/queues/DESIGN/triggers/16?version=4
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "active": false
}

Пример 5: Переместить триггер в списке и активировать.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 4.
• Триггер переносится в позицию перед триггером с идентификатором 6 и активируется.

PATCH /v3/queues/DESIGN/triggers/16?version=4
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{ "before": 6, "active": true }

Формат ответа

{
   "id": 16,
   "self": "https://api.tracker.yandex.net/v3/queues/DESIGN/triggers/16",
   "queue": {
      "self": "https://api.tracker.yandex.net/v3/queues/DESIGN",
      "id": "26",
      "key": "DESIGN",
      "display": "Design"
   },
   "name": "TriggerName",
   "order": "0.0002",
   "actions": [
      {
         "type": "Transition",
         "id": 2,
         "status": {
            "self": "https://api.tracker.yandex.net/v3/statuses/2",
            "id": "2",
            "key": "needInfo",
            "display": "Требуется информация"
         }
      }
   ],
   "conditions": [
      {
         "type": "Or",
         "conditions": [
            { 
               "type": "CommentFullyMatchCondition", 
               "word": "Need info", 
               "ignoreCase": true, 
               "removeMarkup": true, 
               "noMatchBefore": false 
            },
            { 
               "type": "CommentFullyMatchCondition", 
               "word": "Требуется информация", 
               "ignoreCase": true, 
               "removeMarkup": true, 
               "noMatchBefore": false 
            }
         ]
      }
      ],
      "version": 2,
      "active": true
   }