Изменить версию очереди

Запрос позволяет изменить параметры версии очереди.

PATCH

https://api.tracker.yandex.net/v3/versions/{id_версии}

Формат запроса

Перед выполнением запроса получите доступ к API.

Чтобы изменить версию очереди, используйте HTTP-запрос с методом PATCH. В теле запроса укажите изменяемые параметры в формате JSON.

PATCH /v3/versions/{id_версии}
Host: api.tracker.yandex.net
Authorization: OAuth API_TOKEN
Content-Type: application/json
X-Org-ID или X-Cloud-Org-ID: ИДЕНТИФИКАТОР_ОРГАНИЗАЦИИ

{
    "name": "Версия 1.1"
}
Заголовки

  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth OAUTH_TOKEN при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer IAM_TOKEN при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Identity Hub. Читать подробнее

  • Content-Type: формат тела запроса. Должен иметь значение application/json.

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • если к Трекеру привязана организация Яндекс 360 для бизнеса, используйте заголовок X-Org-ID,

    • если к Трекеру привязана организация Yandex Identity Hub, используйте заголовок X-Cloud-Org-ID.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
id_версии Идентификатор версии. Число
Параметры запроса
Параметр Описание Тип данных
fields Список возвращаемых полей через запятую: version, queue, name, description, startDate, dueDate, releasedAt, released, archived, next. Поля self и id возвращаются всегда. Строка
Параметры тела запроса
Параметр Описание Тип данных
name Новое название версии. Строка
description Новое описание версии. Строка
startDate Новая дата начала версии в формате YYYY-MM-DD. Строка
dueDate Новая дата завершения версии в формате YYYY-MM-DD. Строка

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

Тело ответа содержит JSON-объект с измененными параметрами версии.

{
    "self": "https://api.tracker.yandex.net/v3/versions/123",
    "id": 123,
    "version": 2,
    "queue": {
        "self": "https://api.tracker.yandex.net/v3/queues/TEST",
        "id": "1",
        "key": "TEST",
        "display": "Тестовая очередь"
    },
    "name": "Версия 1.1",
    "description": "Описание версии",
    "startDate": "2026-08-26",
    "dueDate": "2026-08-27",
    "released": false,
    "archived": false
}

Если параметры запроса имеют недопустимый формат, API возвращает код ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
Предыдущая
Получить версию очереди
Следующая
Удалить версию очереди