Creating a board

Use this request to create boards.

Request formatRequest format

Before making a request, get permission to access the API.

To create a board, use an HTTP POST request: Request parameters are provided in the request body in JSON format.

POST /v2/boards/
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID: <organization ID>

{
 "name" : "Testing",
 "defaultQueue": {
        "id": 111,
        "key": "test"
        }
}

Example 1: Create a board named Testing. Set a filter using the filter object.

• An HTTP POST method is used.

POST /v2/boards/
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_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"
     }
}

Note

If you only have a Yandex Cloud Organization organization, use the X-Cloud-Org-ID header; if only Yandex 360 for Business or both organization types, use X-Org-ID.

Example 2: Create a board named Testing. Set a filter using the query language.

• An HTTP POST method is used.

POST /v2/boards/
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

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

Response formatResponse format

{
  "self": "https://https://api.tracker.yandex.net/v2/boards/1",
  "id": 1,
  "version": 1,
  "name": "Testing",
  "columns":
  [
   {
    "self": "https://https://api.tracker.yandex.net/v2/boards/1/columns/13874********",
    "id": "13874********",
    "display": "Open"
   },
    ...
  ],
  "filter": {
     "<parameter_1_key>": "<value_1>",
     "<parameter_2_key>": [
          "<value_2>",
                         ...
        ],
         ...
     },
  "orderBy": "updated",
  "orderAsc": false,
  "query": "<parameter_1>: <value_1> AND <parameter_2>: <value_2> OR <parameter_3>: <value_3>...",
  "useRanking": false,

  "country": {
       "self": "https://https://api.tracker.yandex.net/v2/countries/1",
       "id": "1",
       "display": "Russia"
        }
}