Move an issue to another queue using an API request
Use this request to move an issue to a different queue.
Before executing the request, make sure the user has permission to edit the issues to be moved and is allowed to create them in the new queue.
Warning
If an issue you want to move has a type and status that are missing in the target queue, no transfer will be made. To reset the issue status to the initial value when moving it, use the InitialStatus
parameter.
By default, when an issue is moved, the values of its components, versions, and projects are cleared. If the new queue has the same values of the fields specified, use the MoveAllFields
parameter to move the components, versions, and projects.
If the issue has the local field values specified, they will be reset when moving the issue to a different queue.
Request format
Before making the request, get permission to access the API.
To move issues, use an HTTP POST
request:
POST /v2/issues/<issue_id_or_key>/_move?queue=<queue_id_or_key>
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-ID
header is used. - If a Yandex Cloud Organization organization is the only one linked to Tracker, the
X-Cloud-Org-ID
header is used. - If both Yandex 360 for Business and Yandex Cloud Organization organizations are linked to Tracker at the same time, the
X-Org-ID
header 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 |
---|---|---|
<issue_key_or_ID> | ID or key of the current issue. | String |
Request parameters
Required parameters
Parameter | Description | Data type |
---|---|---|
<queue_ID_or_key> | Key of the queue to move the issue to. | String |
Additional parameters
Parameter | Description | Data type |
---|---|---|
notify | Flag indicating if users should be notified about issue changes:
|
Logical |
notifyAuthor | Flag notifying the issue reporter:
|
Logical |
moveAllFields | Shows whether to move the issue's versions, components, and projects to the new queue:
|
Logical |
initialStatus | Resetting the issue status. The status is reset if the issue is moved to another queue with a different workflow:
|
Logical |
expand | Additional fields to include in the response:
|
String |
Request body parameters
You can use the request body if you need to change the parameters of the issue being moved. The request body has the same format as when editing issues.
Example: Move an issue
- An HTTP POST method is used.
- Moving the TEST-1 issue to the NEW queue.
POST /v2/issues/TEST-1/_move?queue=NEW Host: https://api.tracker.yandex.net Authorization: OAuth <OAuth token> X-Org-ID: <organization ID>
Response format
If the request is successful, the API returns a response with code 200 OK
.
The response body contains the results in JSON format.
{
"self": "https://https://api.tracker.yandex.net/v2/issues/NEW-1",
"id": "1a********",
"key": "NEW-1",
"version": 2,
"aliases": [
"TEST-1"
],
"previousQueue": {
"self": "https://https://api.tracker.yandex.net/v2/queues/TEST",
"id": "3",
"key": "TEST",
"display": "TEST"
},
"description": "Move the issue to a new queue",
"type": {
"self": "https://https://api.tracker.yandex.net/v2/issuetypes/2",
"id": "2",
"key": "task",
"display": "Issue"
},
"createdAt": "2020-09-04T14:18:56.776+0000",
"updatedAt": "2020-11-12T12:38:19.040+0000",
"lastCommentUpdatedAt": "2020-10-18T13:33:44.291+0000",
},
"summary": "Test",
"updatedBy": {
"self": "https://https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Ivan Ivanov"
},
"priority": {
"self": "https://https://api.tracker.yandex.net/v2/priorities/3",
"id": "3",
"key": "normal",
"display": "Normal"
},
"followers": [
{
"self": "https://https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Ivan Ivanov"
}
],
"createdBy": {
"self": "https://https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Ivan Ivanov"
},
"assignee": {
"self": "https://https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Ivan Ivanov"
},
"queue": {
"self": "https://https://api.tracker.yandex.net/v2/queues/NEW",
"id": "5",
"key": "NEW",
"display": "Queue"
},
"status": {
"self": "https://https://api.tracker.yandex.net/v2/statuses/8",
"id": "1",
"key": "open",
"display": "Open"
},
"previousStatus": {
"self": "https://https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Open"
},
"favorite": false
}
Response parameters
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the issue. | String |
id | Issue ID. | String |
key | Issue key. | String |
version | Issue version. Each change to the issue parameters increases its version number. | Number |
aliases | Array with information about alternative issue keys. | Array of strings |
previousQueue | Object with information about the issue's previous queue. | Object |
description | Issue description. | String |
type | Object with information about the issue type. | Object |
createdAt | Issue creation date and time. | String |
updatedAt | Issue update date and time. | String |
lastCommentUpdatedAt | Date and time when the last comment was added. | String |
summary | Issue name. | String |
updatedBy | Object with information about the user who edited the issue last. | Object |
priority | Object with information about the priority. | Object |
followers | Array of objects with information about issue followers. | Array of strings |
createdBy | Object with information about the user who created the issue. | Object |
assignee | Object with information about the issue's assignee. | Object |
queue | Object with information about the issue queue. | Object |
status | Object with information about the issue status. | Object |
previousStatus | Object with information about the previous status of the issue. | Object |
favorite | Favorite issue flag:
|
Logical |
previousQueue
object fields
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the queue. | String |
id | Queue ID. | String |
key | Queue key. | String |
display | Queue name displayed. | String |
Object fields type
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the issue type. | String |
id | ID of the issue type. | String |
key | Key of the issue type. | String |
display | Issue type name displayed. | String |
updatedBy
{#updated-by} object fields
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 |
Object fields priority
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the priority. | String |
id | Priority ID. | String |
key | Priority key. | String |
display | Priority name displayed. | String |
followers
object array fields
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 |
createdBy
object fields
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 |
assignee
object fields
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 |
queue
object fields
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the queue. | String |
id | Queue ID. | String |
key | Queue key. | String |
display | Queue name displayed. | String |
status
object fields
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the status. | String |
id | Status ID. | String |
key | Status key. | String |
display | Status name displayed. | String |
previousStatus
object fields
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource with information about the status. | String |
id | Status ID. | String |
key | Status key. | String |
display | Status name displayed. | String |
If the request is processed incorrectly, the API returns a response with an error code:
- 401
- The user isn't authorized. Make sure to perform the actions described in API access.
- 403
- Insufficient rights to perform this action. You can check what rights you have in the Tracker interface. The same rights are required to perform an action via the API and interface.
- 404
- The requested object was not found. You may have specified an invalid object ID or key.