# collection

> Reference for the collection tool of Video: collections, with every action and what it does.

Source: https://video.geenius.io/docs/reference/collection/

Named, ordered sets of videos, with batch actions to duplicate, re-theme or re-size a whole collection. A video may be in several collections.

Call it as `geenius_video(tool: "collection", action: "<action>", args: {...})` through Geenius OS.

## Actions

| Action | What it does |
|---|---|
| `list` | Collections with their video count and up to four posters. |
| `read` | One collection: its videos in show order, without their specs. |
| `create` | A new collection, optionally with videos already in it. |
| `update` | Changes a collection's name, description, tags, brand or aspect. |
| `delete` | Removes the COLLECTION only (its videos stay); confirm must be its exact name or id. |
| `add` | Adds videos to a collection. A video may be in several collections. |
| `remove` | Takes videos out of the collection only (the videos stay). |
| `reorder` | Puts a collection's videos in the order wanted (ids you leave out follow, in their old order). |
| `duplicate` | Copies EVERY video into a new collection, optionally already re-themed (brand, mode, accent, theme) and/or re-sized (size). Copies are drafts; a person renders them.  |
| `retheme` | Changes brand, mode, accent and/or theme of every video IN PLACE (their renders become stale).  |
| `resize` | Changes every video's size IN PLACE (vertical, square, ...).  |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "list"`. The server answers from its own definitions, so that answer is always current.

> [!NOTE]
> Batch actions list a video that cannot take the change in `skipped` with its reason; the rest go through. At most 60 videos per batch.