Objects

Delete a Media Object instance

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.

delete/objects/{objectId}/instances

Path parameters

objectIdstring required

The Media Object identifier. The Object ID may include special characters such as / which should be URL encoded.

Query parameters

storage_idstring

The storage_id identifying the Media Object instance to be deleted.

labelstring

The label identifying the Media Object instance to be deleted.

Response

No content. The Media Object instance has been deleted.

Changes