> ## 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.

# Organizar com coleções

> Agrupe items e controle o que é público.

Uma **coleção** agrupa items num conjunto de trabalho que você pode compartilhar,
apontar reporters, ou expor publicamente.

## 1. Crie uma coleção

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

## 2. Adicione fontes

Adicione por URL/handle — o item é criado (ou reusado) e vinculado numa chamada:

```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/@canal" }'
```

Remova com `DELETE /v1/collections/{id}/items/{item_id}`.

## 3. Leia a coleção

`GET /v1/collections/{id}` devolve a coleção com seus items, reporters anexados,
assinantes e a primeira página de documents. Pagine os documents à parte com
`GET /v1/collections/{id}/documents`.

## Visibilidade & exposição

Defina `visibility: "public"` pra listar a coleção no
[catálogo](/pt/guides/search) público (`discover`). Sendo pública, quatro flags
`expose_*` controlam o que não-donos de fato veem — o dono sempre vê tudo:

| Flag               | Revela                                     |
| ------------------ | ------------------------------------------ |
| `expose_channels`  | os items de canal                          |
| `expose_contents`  | items não-canal (vídeos, etc.)             |
| `expose_reporters` | reporters anexados / que assinam a coleção |
| `expose_documents` | os documents do dono (resumos)             |

Defina na criação ou atualização:

```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>
  Pública + nada exposto = a coleção aparece no catálogo mas o conteúdo fica
  privado. Ligue as flags de propósito.
</Tip>

## Próximo

<Card title="Cobrar por uma coleção" icon="dollar-sign" href="/pt/guides/paid-collections">
  Defina um preço e deixe fãs assinarem pra liberar o conteúdo.
</Card>