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

# Collections

> Manage memory collections (personal, team, knowledge, hive)

A **collection** groups related memories. Each 60db workspace has automatic per-user personal collections, plus any team/knowledge/hive collections created by owners/admins.

## List collections

`GET /memory/collections`

Returns all collections the caller can access in the current workspace.

```bash theme={null}
curl https://api.60db.com/memory/collections \
  -H "Authorization: Bearer sk_abc123"
```

```json Response theme={null}
{
  "success": true,
  "data": [
    {
      "hash_id": "uuid-1",
      "collection_id": "user_abc123",
      "label": "Personal Memories",
      "kind": "personal",
      "owner_user_id": 42,
      "shared": false,
      "created_at": "2026-04-01T10:00:00Z"
    },
    {
      "hash_id": "uuid-2",
      "collection_id": "customer_support",
      "label": "Customer Support KB",
      "kind": "team",
      "owner_user_id": null,
      "shared": true,
      "created_at": "2026-04-02T14:30:00Z"
    }
  ]
}
```

## Create collection

`POST /memory/collections`

**Permission**: Owner or admin only.

### Body

<ParamField body="collection_id" type="string" required>
  Unique ID within the workspace. Lowercase, alphanumeric, underscore, hyphen.
</ParamField>

<ParamField body="label" type="string" required>
  Human-readable display name.
</ParamField>

<ParamField body="kind" type="string" default="team">
  Collection type. One of: `team`, `knowledge`, `hive`.
</ParamField>

<ParamField body="shared" type="boolean" default="true">
  If true, all workspace members can read memories in this collection.
</ParamField>

<ParamField body="metadata" type="object">
  Arbitrary metadata attached to the collection.
</ParamField>

```bash theme={null}
curl -X POST https://api.60db.com/memory/collections \
  -H "Authorization: Bearer sk_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "customer_support",
    "label": "Customer Support KB",
    "kind": "knowledge",
    "shared": true
  }'
```

## Collection kinds

| Kind        | Use case                                                | Who can read | Who can write    |
| ----------- | ------------------------------------------------------- | ------------ | ---------------- |
| `personal`  | Per-user private memories                               | Owner only   | Owner only       |
| `team`      | Shared team-scoped memories                             | All members  | All members      |
| `knowledge` | Reference documents, policies                           | All members  | Owner/admin only |
| `hive`      | Cross-collection shared facts appearing in every search | All members  | Owner/admin only |