---
title: "Delete a Media Object instance"
method: DELETE
path: "/objects/{objectId}/instances"
tags: ["Objects"]
---

# Delete a Media Object instance

`DELETE /objects/{objectId}/instances`

Delete an instance of a Media Object.

One of `storage_id` or `label` MUST be specified in the query parameters. `storage_id` SHOULD be used where `controlled` is `True` for the instance.

API instances should remove the Media Object instance from the `get_urls` list and then, if the instance is controlled, delete the Object instance from storage.

API instances SHOULD prevent clients from deleting all Object instances. Additionally, API instances MAY prevent clients from deleting all controlled Object instances. Where clients wish to remove all copies of an Object from the store, they should do so by deleting all Flows or Flow Segments which reference the Object.

## Path parameters

- `objectId` string, required

## Query parameters

- `storage_id` string
- `label` string

## Response `204`

No content. The Media Object instance has been deleted.

## Other responses

- `400` — Bad request. Invalid query options.
- `403` — Forbidden. You do not have permission to modify this Media Object.
- `404` — The requested Object ID in the path is invalid.

## Changes

- **2025-10-16** `b23d7880c91d` — 1 info
  - endpoint added
- **2025-04-24** `b01aaf8cffe2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/objects/:objectId/instances/delete.md)

---

[API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/4c8d2bfcb854/schema)