> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/collections/introduction.md

## Article Content:

# About the Collections API

The Collections API allows you to manage collections in a portfolio. A collection is a way to group similar projects together in your portfolio. Learn more about [collections in Wix Portfolio](https://support.wix.com/en/article/wix-portfolio-adding-and-setting-up-wix-portfolio#step-3-create-collections).


With the Collections API, you can:

+ [Create](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/create-collection.md), [update](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/update-collection.md), and [delete](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/delete-collection.md) collections. 
+ [Retrieve](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/get-collection.md), [list](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/list-collections.md), and [query](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/query-collections.md) collections.
+ Listen for events when a collection is [created](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/collection-created.md), [updated](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/collection-updated.md), and [deleted](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/collection-deleted.md). 

## Before you begin

It's important to note the following points before starting to code:

+ After creating a collection, you can assign a new or existing project to the collection by specifying the collection's ID in the `collectionIds` parameter of the [Create Project](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/create-project.md) or [Update Project](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/update-project.md) methods. 
+ You can only use this API on sites where a Wix user has installed the [Wix Portfolio app](https://www.wix.com/app-market/web-solution/wix-portfolio?appIndex=0&collimp_id=b54d3569-fdaa-49f6-83f8-2ac6e400bd11&referralSectionName=wix%20portfolio).

<!-- + After creating a collection, you can assign a new or existing project to the collection by specifying the collection's ID in the `collectionIds` parameter of the [Create Project](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/create-project.md), [Update Project](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/update-project.md), or [Bulk Update Projects](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/bulk-update-projects.md) methods.  -->

## Use cases

+ [Organize photography projects by theme](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/sample-flows.md#organize-photography-projects-by-theme).
+ [Keep your data current with collection events](https://dev.wix.com/docs/rest/business-solutions/portfolio/collections/sample-flows.md#keep-your-data-current-with-collection-events).

@sdk_package_setup