Getting transitions
Written by
Updated at February 19, 2024
Use this request to get a list of possible issue transitions. The issue is selected when its ID or key is specified.
Request format
Before making the request, get permission to access the API.
To get a list of possible transitions, use an HTTP GET request:
GET /v2/issues/<issue_ID_or_key>/transitions
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 |
|---|---|---|
| <issue_key_or_ID> | ID or key of the current issue. | String |
Response format
Request executed successfully
Request failed
If the request is successful, the API returns a response with code 200 OK.
The response body contains the results in JSON format.
[
{
"id": "resolve",
"self": "https://https://api.tracker.yandex.net/v2/issues/JUNE-2/transitions/resolve",
"display": "Resolve",
"to": {
"self": "https://https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Open"
}
},
...
]
Response parameters
| Parameter | Description | Data type |
|---|---|---|
| id | Transition ID. | String |
| self | Address of the API resource with information about the transition. | String |
| display | Transition name displayed. Matches the corresponding button name in the Tracker interface. | String |
| to | Object with information about a new issue status. | Object |
to 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 |
- 404
- The requested object was not found. You may have specified an invalid object ID or key.