Motivation

Items and other content residing within a collection can easily be removed from that collection when needed.

Example

Removing a single item from a collection:

Request

DELETE /collection/VX-2/VX-3?type=item

Where VX-2 is the collection and VX-3 is the item which we want to remove from the collection.

Removing items in bulk

To remove multiple items, we can pass a CollectionDocument specifying which items to remove

PUT /collection/VX-2

With a body telling which items to remove

<CollectionDocument xmlns="http://xml.vidispine.com/schema/vidispine">
    <loc>http://localhost:8080/API/collection/VX-2/</loc>
    <id>VX-2</id>

    <content mode="remove">
        <id>VX-3</id>
        <uri>http://localhost:8080/API/item/VX-3</uri>
        <type>item</type>
        <metadata/>
    </content>
    
    <content mode="remove">
        <id>VX-4</id>
        <uri>http://localhost:8080/API/item/VX-4</uri>
        <type>item</type>
        <metadata/>
    </content>
</CollectionDocument>
CODE

Note: This endpoint also supports the parameter clear which if set to true will remove any item or collection not specifically mentioned in the document from the collection

Resources

For more details see:

https://apidoc.vidispine.com/latest/ref/collection.html#remove-an-item-library-or-collection-from-a-collection

https://apidoc.vidispine.com/latest/ref/collection.html#update-a-collection

How to

Further explanation can be found here:

https://apidoc.vidispine.com/21.4/item/collection.html#update-collection-content