---
title: "Delete uploaded media"
method: POST
path: "/v1/uploads/delete"
tags: ["Uploads"]
---

# Delete uploaded media

`POST /v1/uploads/delete`

## Request

- Base URL: `https://api.hotapi.ai`
- URL: `https://api.hotapi.ai/v1/uploads/delete`
- Auth: HTTP bearer

Delete media files you uploaded, without waiting for the 24-hour expiry. Send the URLs `POST /v1/uploads` returned. Every URL must belong to your organization or the request is rejected and nothing is deleted. Idempotent: URLs whose object is already gone are reported in `already_deleted`. Files already fetched by the model provider when a task ran are governed by the provider's own policy and are not affected.

## Request body

- object
  - `urls` string[], required: Upload URLs to delete (the value returned by POST /v1/uploads). Every URL must belong to your organization or the whole request is rejected.

## Response `200`

Outcome of deleting uploaded input images.

- DeletedUploads: Outcome of deleting uploaded input images.
  - `data` object[], required
    - `url` string, required: The upload URL as submitted.
    - `deleted` boolean, required: True when this call removed the object.
    - `already_deleted` boolean, required: True when the object was already gone (expired or deleted earlier).
  - `deleted_count` integer, required
  - `already_deleted_count` integer, required
  - `cdn_purged_links` integer, required: Links invalidated at the CDN edge. Lower than `deleted_count` means the rest stop working when their cache entry expires (up to 4 hours).

## Other responses

- `400`: Standard error envelope returned by every error response (OpenAI-style).
- `401`: Standard error envelope returned by every error response (OpenAI-style).
- `429`: Standard error envelope returned by every error response (OpenAI-style).

---

[API](https://skmtc.dev/hotapi/apis/hotapi-gateway.md) · [All operations](https://skmtc.dev/hotapi/apis/hotapi-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/hotapi/apis/hotapi-gateway/revisions/9b6578b0c389?raw)