Удалить файл

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

DELETE

https://api.tracker.yandex.net/v3/entities/<тип_сущности>/<id_сущности>/attachments/<id_файла>

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

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

Чтобы удалить файл, используйте HTTP-запрос с методом DELETE.

DELETE /v3/entities/<тип_сущности>/<id_сущности>/attachments/<id_файла>
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_файла> Уникальный идентификатор файла. Строка или число

Пример: Удалить файл, прикрепленный к сущности (проекту).

  • Используется HTTP-метод DELETE.
DELETE https://api.tracker.yandex.net/v3/entities/project/<id_проекта>/attachments/123

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

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

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

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