Skip to main content

Endpoint

DELETE /v1/media/:id
Authorization: Bearer sk_live_...
Deletes the blob from the Shelby network and removes the database record.

Path Parameters

ParamDescription
idMedia file UUID

Example

curl -X DELETE "$API/v1/media/$ID" \
  -H "Authorization: Bearer $API_KEY"

Response (200)

{
  "deleted": true,
  "id": "3449d148-5cc5-4bcc-9e02-242398025dc2"
}
If the blob has already expired on the Shelby network, the delete still succeeds — the database record is removed even if the underlying blob no longer exists.

Credit Cost

This operation costs 2 credits (media.delete).

Errors

StatusReason
404Media not found