Создать доску

Запрос позволяет создать доску.

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

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

Чтобы создать доску, используйте HTTP-запрос с методом POST. Параметры запроса передаются в его теле в формате JSON.

POST /v2/boards/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
 "name" : "Тестирование",
 "defaultQueue": {
        "id": 111,
        "key": "test"
        }
}

Пример 1: Создать доску с названием Testing. Фильтр задать через объект filter.

• Используется HTTP-метод POST.

POST /v2/boards/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
 "name": "Testing",
 "boardType": "default",
 "defaultQueue": {
        "id": "111",
        "key": "test"
        },
 "filter": {
      "assignee": "user1",
      "priority": [
          "normal",
          "critical"
          ]
      },
 "orderBy": "updated",
 "orderAsc": false,
 "useRanking": false,
 "country": {
     "id": "1"
     }
}

Примечание

Если у вас только организация Yandex Cloud Organization, используйте заголовок X-Cloud-Org-ID, если только Яндекс 360 для бизнеса или оба типа организаций — X-Org-ID.

Пример 2: Создать доску с названием Testing. Фильтр задать на языке запросов.

• Используется HTTP-метод POST.

POST /v2/boards/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
 "name": "Testing",
 "boardType": "default",
 "defaultQueue": {
        "id": "111",
        "key": "test"
        },
 "query": "assignee: user1 AND (priority: normal OR priority: critical)",
 "useRanking": false,
 "country": {
     "id": "1"
     }
}

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

{
  "self": "https://api.tracker.yandex.net/v2/boards/1",
  "id": 1,
  "version": 1,
  "name": "Тестирование", 
  "columns": 
  [ 
   {
    "self": "https://api.tracker.yandex.net/v2/boards/1/columns/13874********",
    "id": "13874********",
    "display": "Открыт"
   },
    ...
  ],
  "filter": {
     "<ключ_параметра_1>": "<значение_1>",
     "<ключ_параметра_2>": [
          "<значение_2>", 
                         ...
        ],
         ...
     },
  "orderBy": "updated",
  "orderAsc": false,
  "query": "<параметр_1>: <значение_1> AND <параметр_2>: <значение_2> OR <параметр_3>: <значение_3>...",
  "useRanking": false,
  
  "country": {
       "self": "https://api.tracker.yandex.net/v2/countries/1",
       "id": "1",
       "display": "Россия"
        }
}