Restoring a queue
Written by
Updated at February 19, 2024
Warning
This request can only be made on behalf of the administrator.
Use this request to restore a deleted queue.
Request format
Before making the request, get permission to access the API.
To restore a deleted queue, use an HTTP POST request.
POST /v2/queues/<queue_ID_or_key>/_restore
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID: <organization ID>
Headers
-
Host
Address of the node that provides the API:
https://api.tracker.yandex.net -
Authorization
OAuth token in
OAuth <OAuth_token>format, e.g.:OAuth 0c4181a7c2cf4521964a72ff******** -
X-Org-ID or X-Cloud-Org-ID
Organization ID. You can find it out on the Tracker organizations page.
- If a Yandex 360 for Business organization is the only one linked to Tracker, the
X-Org-IDheader is used. - If a Yandex Cloud Organization organization is the only one linked to Tracker, the
X-Cloud-Org-IDheader is used. - If both Yandex 360 for Business and Yandex Cloud Organization organizations are linked to Tracker at the same time, the
X-Org-IDheader and the Yandex 360 for Business organization ID are used.
- If a Yandex 360 for Business organization is the only one linked to Tracker, the
Resource
| Parameter | Description | Data type |
|---|---|---|
| <queue_ID_or_key> | Queue ID or key. The queue key is case-sensitive. | String or number |
Response format
Request executed successfully
Request failed
If the request is successful, the API returns a response with code 200 OK.
{
"self": "https://https://api.tracker.yandex.net/v2/queues/TEST",
"id": "3",
"key": "TEST",
"version": 5,
"name": "Test",
"lead": {
"self": "https://https://api.tracker.yandex.net/v2/users/11********",
"id": "11********",
"display": "Ivan Ivanov"
},
"assignAuto": false,
"defaultType": {
"self": "https://https://api.tracker.yandex.net/v2/issuetypes/1",
"id": "1",
"key": "bug",
"display": "Error"
},
"defaultPriority": {
"self": "https://https://api.tracker.yandex.net/v2/priorities/3",
"id": "3",
"key": "normal",
"display": "Normal"
},
"denyVoting": false
}
Response parameters
| Parameter | Description | Data type |
|---|---|---|
| self | Queue link. | String |
| id | Queue ID. | Number in string format |
| key | Queue key. | String |
| version | Queue version. Each change to the queue increases its version number. | Number |
| name | Queue name | String |
| lead | Block with information about the queue owner | Object |
| assignAuto | Automatically assign new issues in the queue:
|
Logical |
| defaultType | Block with information about the default issue type | Object |
| defaultPriority | Block with information about the default issue priority | Object |
| denyVoting | Flag that shows whether voting for issues is enabled | Logical |
| Parameter | Description | Data type |
|---|---|---|
| self | Address of the API resource with information about the user. | String |
| id | User ID. | String |
| display | User's name displayed. | String |
defaultType object fields
| Parameter | Description | Data type |
|---|---|---|
| self | Link to the issue type | String |
| id | ID of the issue type | String |
| key | Key of the issue type | String |
| display | Issue type name displayed | String |
defaultPriority object fields
| Parameter | Description | Data type |
|---|---|---|
| self | Link to the priority type | String |
| id | Priority ID | String |
| key | Priority key | String |
| display | Priority name displayed | String |
If the request is processed incorrectly, the API returns a response with an error code:
- 404
- The requested object was not found. You may have specified an invalid object ID or key.