Создать приоритет

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

POST

https://api.tracker.yandex.net/v3/priorities/

Для выполнения запроса требуются права администратора.

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

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

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

POST /v3/priorities/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": {
        "en": "English name",
        "ru": "Название на русском"
    },
    "key": "one",
    "order": 60,
    "description": "Описание"
}
Заголовки

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

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

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

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

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

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

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

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

Параметры тела запроса

Тело запроса содержит информацию, необходимую для создания нового приоритета.

Обязательные параметры

Параметр Описание Тип данных
name Название приоритета Объект
key Ключ приоритета Строка
order Вес приоритета. Параметр влияет на порядок отображения приоритета в интерфейсе Число
description Описание приоритета Строка

Поля объекта name

Параметр Описание Тип данных
en Название приоритета на английском Строка
ru Название приоритета на русском Строка

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

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

Тело запроса содержит информацию о созданном приоритете в формате JSON.

{
    "self": "https://api.tracker.yandex.net/v3/priorities/6",
    "id": 6,
    "key": "one",
    "version": 1,
    "name": "Название на русском",
    "description": "Описание",
    "order": 60
}
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о приоритете Строка
id Уникальный идентификатор приоритета в Трекере Число
key Ключ приоритета Строка
version Версия приоритета Число
name Название приоритета Строка
description Описание приоритета Строка
order Вес приоритета. Параметр влияет на порядок отображения приоритета в интерфейсе Число
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
409
При редактировании объекта возник конфликт. Возможно, ошибка возникла из-за неправильно указанной версии изменений.
Предыдущая
Получить список приоритетов
Следующая
Редактировать приоритет