Get queue versions

Use this request to get information about queue versions. The queue is selected when an ID or key is specified.

Request format

To get the queue versions, use an HTTP GET request:

GET /v2/queues/<queue-id>/versions
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth token>
X-Org-Id: <organization ID>
Request parameters
<queue-id>
The ID or key of the queue.

Request for versions of the “TEST” queue:

  • Uses the HTTP GET method.

GET /v2/queues HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth token>
X-Org-Id: <organization ID>
Cache-Control: no-cache

Response format

[
    {
        "self": "https://api.tracker.yandex.net/v2/versions/49650",
        "id": 49650,
        "version": 1,
        "queue": {
            "self": "https://api.tracker.yandex.net/v2/queues/JUNE",
            "id": "1928",
            "key": "JUNE",
            "display": "june"
        },
        "name": "version1",
        "description": "iohb ±!@#$%^&*()_+=-/\\?<>.,/§:»'|;",
        "startDate": "2017-06-09",
        "dueDate": "20227-06-09",
        "released": false,
        "archived": false
    },
    ...
]
Response parameters
Parameter Description Data type
self

Reference to the version object.

String.

id

Version ID.

Integer.

version

Version number.

Integer.

queue

Object with queue information.

Object.

name

The name of the version.

String.

description

Text description of the version.

String.

startDate

The starting date of the queue.

String.

dueDate

The end date of the queue.

String.

released

Whether the version has been released.

Boolean.

archived

Whether this is an archived version.

Boolean.

Fields for the queue object
self

Reference to the queue.

String.

id

The queue ID.

String.

key

The queue key.

String.

display

Display name of the queue.

String.

Parameter Description Data type
self

Reference to the version object.

String.

id

Version ID.

Integer.

version

Version number.

Integer.

queue

Object with queue information.

Object.

name

The name of the version.

String.

description

Text description of the version.

String.

startDate

The starting date of the queue.

String.

dueDate

The end date of the queue.

String.

released

Whether the version has been released.

Boolean.

archived

Whether this is an archived version.

Boolean.

Fields for the queue object
self

Reference to the queue.

String.

id

The queue ID.

String.

key

The queue key.

String.

display

Display name of the queue.

String.

Possible response codes

200
The request was successful.
404
The requested object was not found. You might have entered an incorrect object ID or key value.