Skip to main content
DELETE
Удалить файл
Удаляет файл из хранилища. Объект удаляется, запись помечается удалённой, и файл сразу пропадает из списка.

Пример

Ответ

200 OK:

Что происходит после удаления

  • GET /api/v1/storage/{id} по этому идентификатору начинает отдавать 404.
  • Файл исчезает из выдачи GET /api/v1/storage.
  • Ссылка url перестаёт отдавать содержимое.
Отменить удаление нельзя. Отдельного маршрута восстановления у хранилища на /api/v1 нет — если нужна страховка, держите копию файла у себя.

Чужие файлы

Файл, принадлежащий другому пользователю, возвращает 404, а не 403. По коду ответа нельзя определить, что идентификатор существует, но принадлежит другому владельцу.

Ошибки

Формат тела ошибки такой же, как у остальных эндпоинтов хранилища: {"error": {"message": "...", "type": "invalid_request"}} — без полей param и code, которые есть у OpenAI-формата. Подробности — на странице Ошибки.

Что дальше

Список файлов

Проверить, что файл исчез

Загрузить файл

Загрузить файл заново

Метаданные файла

Один файл по идентификатору

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

Параметры пути

id
string
обязательно

Ответ

Файл удалён.

success
boolean
обязательно
asset_id
string
обязательно