Редактировать доску

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

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

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

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

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

<новые_параметры_доски_в_формате_JSON>

Пример: Изменить параметры доски с идентификатором 5.

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

PATCH /v2/boards/5
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор_организации>
If-Match: "<номер_версии>"

{
 "name": "Testing new",
 "columns":
    [
      {
        "id": "1",
        "name": "Открыт",
        "statuses": "open"
       },
       {
        "id": "2",
        "name": "Закрыт",
        "statuses": "closed"
       }
     ],
 "filter": {
      "assignee": "user1",
      "priority": [
          "normal",
          "blocker",
          "critical"
          ]
      },
 "orderBy": "created",
 "orderAsc": true,
 "useRanking": true,
 "country": {
      "id": "1"
      }
}

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

{
  "self": "https://api.tracker.yandex.net/v2/boards/1",
  "id": 1,
  "version": 1412806202302,
  "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": "Россия"
        }
   }