Удалить связь сущностей

Запрос позволяет удалить связь между двумя сущностями.

DELETE

https://api.tracker.yandex.net/v3/entities/<тип_сущности>/<id_сущности>/links

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

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

Для удаления связи используйте HTTP-запрос с методом DELETE. Связь удаляется между текущей сущностью (идентификатор указывается в <id_сущности> запроса) и сущностью, идентификатор которой указан в параметре right запроса.

DELETE /v3/entities/<тип_сущности>/<id_сущности>/links
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки

  • 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.

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

Ресурс
Параметр Описание Тип данных
<тип_сущности> Тип сущности:
  • project — проект;
  • portfolio — портфель;
  • goal — цель
 Строка
<id_сущности> Идентификатор сущности. Чтобы получить идентификатор, посмотрите список сущностей. В качестве идентификатора можно использовать параметр id или shortId. Строка
Параметры запроса

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

Параметр Описание Тип данных
right Идентификатор сущности, с которой удаляется связь. Строка

Пример: Удалить связь между сущностями

  • Используется HTTP-метод DELETE.
DELETE https://api.tracker.yandex.net/v3/entities/project/<id_проекта>/links?right=<id_сущности>

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

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

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

400
Один или несколько параметров запроса имеют недопустимое значение.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
422
Ошибка валидации JSON, запрос отклонен.
Предыдущая
Получить связи
Следующая
Получить настройки доступа