Skip to main content
The DELETE /v1/objects endpoint permanently removes a specific object from your Virtus Cloud Blob account. Once deleted, the object and its CDN URL are no longer accessible. This action cannot be undone, so make sure you no longer need the file before calling this endpoint. Endpoint: DELETE https://blob.virtuscloud.app/v1/objects

​
Authentication

Include your API key in the Authorization header: 
Authorization: <your-api-key>
See the Authentication page for details.

​
Request Body

Send the request body as JSON with the Content-Type: application/json header.
​
object
string
required
The full ID of the object to delete. This is the id field returned when you uploaded the object or listed your objects. The value follows the pattern accountID/filename. Example:
{ "object": "ID/prefix/name1_ltq7b2sw-de6241.jpeg" }

​
Example Request

curl -X DELETE "https://blob.virtuscloud.app/v1/objects" \
  -H "Authorization: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"object": "3155597145698959364/test_lxch4k7y-07ee.png"}'
Deletion is permanent and immediate. Once you receive a "success" response, the object and its associated CDN URL are gone and cannot be recovered.

​
Response

​
status
string
Indicates whether the request succeeded. Returns "success" on success or "error" on failure.
Example Response
{
  "status": "success"
}

​
Troubleshooting

A 400 response means the object identifier you provided failed validation or the deletion could not be completed.
// The provided object ID is malformed or uses disallowed characters.
{
  "status": "error",
  "code": "INVALID_OBJECT"
}