---
title: "Delete an Object"
method: DELETE
path: "/buckets/{slug}/objects/{object_id}"
tags: ["Objects"]
---

# Delete an Object

`DELETE /buckets/{slug}/objects/{object_id}`

Delete an Object from the Bucket. This is destructive and not reversible through the API: confirm with the user before calling it.

## Query parameters

- `trigger_webhook` boolean

## Response `200`

The Object was deleted.

- MessageResponse — Returned by delete operations.
  - `message` string, required

## Other responses

- `401` — The access key is missing or incorrect.
- `402` — The Bucket needs to be upgraded before it can be used again.
- `404` — The addressed resource does not exist in this Bucket. Note that this covers a resource missing from a route that exists; an unrecognized route answers 200 with a `Route not found` body instead, as described in the API description above.
- `429` — Too many requests hit the API too quickly. Back off and retry.
- `500` — Something went wrong on the Cosmic side.

---

[API](https://skmtc.dev/cosmicjs/apis/cosmic-rest-api-v3.md) · [All operations](https://skmtc.dev/cosmicjs/apis/cosmic-rest-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cosmicjs/cosmic-rest-api-v3/revisions/e0aa2a0913b3/schema)