Skip to main content
Skip table of contents

UC Remove Items from a Collection

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

CODE
<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>

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.