Удалить файл

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

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 API_TOKEN
X-Org-ID или X-Cloud-Org-ID: ИДЕНТИФИКАТОР_ОРГАНИЗАЦИИ
Заголовки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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