Restoring a queue
Use this request to restore a deleted queue.
POST
https://api.tracker.yandex.net/v3/queues/<queue_ID>/_restore
This request can only be made on behalf of the administrator.
Query format
Before making a request, get permission to access the API.
To restore a deleted queue, use an HTTP POST
request.
POST /v3/queues/<queue_ID>/_restore
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>
Headers
-
Host
: Address of the node that provides the API. -
Authorization
: Authorization token about these formats:-
OAuth <OAuth_token>
: For authorization using the OAuth 2.0 protocol. Learn more -
Bearer <IAM_token>
: For authorization using an IAM token, if a Yandex Cloud Organization organization is linked to Tracker. Learn more
-
-
X-Org-ID
orX-Cloud-Org-ID
: Organization ID.-
Use the
X-Org-ID
header if a Tracker organization is linked to Yandex 360 for Business. -
Use the
X-Cloud-Org-ID
header if a Tracker organization is linked to Yandex Cloud Organization.
To get the organization ID, go to Administration → Organizations and copy the value from the ID field.
-
Resource
Parameter | Description | Data type |
---|---|---|
<queue_ID> | Queue ID or key. The queue key is case-sensitive. | String or number |
Response format
If the request is successful, the API returns a response with code 200 OK
.
{
"self": "https://api.tracker.yandex.net/v3/queues/TEST",
"id": "3",
"key": "TEST",
"version": 5,
"name": "Test",
"lead": {
"self": "https://api.tracker.yandex.net/v3/users/11********",
"id": "11********",
"display": "Ivan Ivanov"
},
"assignAuto": false,
"defaultType": {
"self": "https://api.tracker.yandex.net/v3/issuetypes/1",
"id": "1",
"key": "bug",
"display": "Error"
},
"defaultPriority": {
"self": "https://api.tracker.yandex.net/v3/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 | Map item |
assignAuto | Automatically assign new issues in the queue:
|
Boolean |
defaultType | Block with information about the default issue type | Map item |
defaultPriority | Block with information about the default issue priority | Map item |
denyVoting | Flag that shows whether voting for issues is enabled | Boolean |
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the user | String |
id | User ID. | String |
display | Displayed user name | String |
passportUid | Unique ID of the user account in the Yandex 360 for Business organization and Yandex ID. | Number |
cloudUid | Unique user ID in Yandex Cloud Organization | 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.