> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Organize with collections

> Group items and control what's public.

A **collection** groups items into a working set you can share, point reporters
at, or expose publicly.

## 1. Create a collection

```bash theme={null}
curl -X POST https://api.clipping.cc/v1/collections \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "name": "AI channels", "visibility": "private", "language": "en" }'
```

## 2. Add sources

Add by URL/handle — the item is created (or reused) and linked in one call:

```bash theme={null}
curl -X POST https://api.clipping.cc/v1/collections/col_123/items \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "source": "https://youtube.com/@channel" }'
```

Remove with `DELETE /v1/collections/{id}/items/{item_id}`.

## 3. Read it

`GET /v1/collections/{id}` returns the collection with its items, attached
reporters, subscribers, and a first page of documents. Paginate documents
separately with `GET /v1/collections/{id}/documents`.

## Visibility & exposure

Set `visibility: "public"` to list the collection in the public
[catalog](/en/guides/search) (`discover`). When public, four `expose_*` flags
control what non-owners actually see — the owner always sees everything:

| Flag               | Reveals                                            |
| ------------------ | -------------------------------------------------- |
| `expose_channels`  | the channel items                                  |
| `expose_contents`  | non-channel items (videos, etc.)                   |
| `expose_reporters` | reporters attached to / subscribing the collection |
| `expose_documents` | the owner's documents (summaries)                  |

Set them on create or update:

```bash theme={null}
curl -X PATCH https://api.clipping.cc/v1/collections/col_123 \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "visibility": "public", "expose_channels": true, "expose_documents": true }'
```

<Tip>
  Public + nothing exposed = the collection shows up in the catalog but its
  contents stay private. Turn flags on deliberately.
</Tip>

## Next

<Card title="Charge for a collection" icon="dollar-sign" href="/en/guides/paid-collections">
  Set a price and let fans subscribe to unlock gated content.
</Card>