Getting transitions

Use this request to get a list of possible issue transitions. The issue is selected when its ID or key is specified.

GET

https://api.tracker.yandex.net/v3/issues/<issue_ID>/transitions

Query format

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

To get a list of possible transitions, use an HTTP GET request:

GET /v3/issues/<issue_ID>/transitions
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 or X-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
<issue_key_or_ID> ID or key of the current issue. String

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.

[
    {
        "id": "resolve",
        "self": "https://api.tracker.yandex.net/v3/issues/JUNE-2/transitions/resolve",
        "display": "Resolve",
        "to": {
            "self": "https://api.tracker.yandex.net/v3/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. Map item

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.
Previous
Getting priorities
Next
Making a status transition