Uploads

Delete uploaded media

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.

post/v1/uploads/delete

Request

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

Request body

urlsstring[] 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.

Example request

{
  "urls": [
    "https://cdn.hotapi.ai/uploads/org_8sd9f7aQ2/V1StGXR8Z5.png"
  ]
}

Response

Outcome of deleting uploaded input images.

deleted_countinteger required
already_deleted_countinteger required
cdn_purged_linksinteger 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).

Changes

No recorded changes to this operation across all 1 revision of this API.