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

# Kolekcje

> Tworzenie i zarządzanie kolekcjami wiedzy

Kolekcje to kontenery na Twoją wiedzę. Wgraj dokumenty do kolekcji, a Aigmented wyekstrahuje ustrukturyzowane karty wiedzy, które możesz przeszukiwać i odpytywać.

## Lista kolekcji

```bash theme={null}
curl https://aigmented.io/api/v1/collections/list \
  -H "Authorization: Bearer sk-TWOJ_KLUCZ_API"
```

Zwraca wszystkie kolekcje zespołu:

```json theme={null}
{
  "message": "List of collections",
  "data": [
    {
      "id": 49,
      "name": "Dokumentacja produktowa",
      "status": "processed",
      "_count": {
        "knowledgeCards": 1248,
        "fileInstances": 4
      }
    }
  ]
}
```

## Szczegóły kolekcji

```bash theme={null}
curl https://aigmented.io/api/v1/collections/49 \
  -H "Authorization: Bearer sk-TWOJ_KLUCZ_API"
```

## Tworzenie kolekcji

```bash theme={null}
curl -X POST https://aigmented.io/api/v1/collections/add \
  -H "Authorization: Bearer sk-TWOJ_KLUCZ_API" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Umowy Q4 2024" }'
```

## Usuwanie kolekcji

```bash theme={null}
curl -X DELETE https://aigmented.io/api/v1/collections/49 \
  -H "Authorization: Bearer sk-TWOJ_KLUCZ_API"
```

<Warning>
  Usunięcie kolekcji powoduje usunięcie wszystkich powiązanych kart wiedzy. Tej operacji nie można cofnąć.
</Warning>

## Statusy kolekcji

| Status                     | Znaczenie                                        |
| -------------------------- | ------------------------------------------------ |
| `new`                      | Kolekcja utworzona, żadne pliki nie przetworzone |
| `processing`               | Pliki są przetwarzane i wiedza jest ekstrahowana |
| `processed`                | Wszystkie pliki przetworzone pomyślnie           |
| `processed_with_conflicts` | Przetworzone, ale niektóre karty mają konflikty  |
| `error`                    | Przetwarzanie nie powiodło się                   |

## Lista kart wiedzy

```bash theme={null}
curl "https://aigmented.io/api/v1/collections/49/knowledge-cards?page=1&limit=20" \
  -H "Authorization: Bearer sk-TWOJ_KLUCZ_API"
```

Obsługuje paginację (`page`, `limit`), filtrowanie po typie (`type`) i wyszukiwanie pełnotekstowe (`search`).