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

# Delete an Object instance

`DELETE /objects/{objectId}/instances`

Delete an instance of a 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 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.

API instances SHALL NOT cascade the deletion of Object instances to initialisation Objects.
Clients MUST initiate the deletion of Object instances of initialisation Objects directly.

## Path parameters

- `objectId` string, required

## Query parameters

- `storage_id` string
- `label` string

## Response `204`

No content. The Object instance has been deleted.

## Other responses

- `400` — Bad request. Invalid query options.
- `403` — Forbidden. You do not have permission to modify this Object.
- `404` — The requested Object ID in the path is invalid. 404 MUST be returned if the ID has been assigned via the [`/flows/{flowId}/storage`](#/operations/POST_flows-flowId-storage), but not yet registered against a Flow Segment.

## Changes

> 23 revisions in range; 16 could not be searched.

- **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/eb3977b33601/schema)