# List knowledge bases

`GET https://app.whatsetter.com/api/v1/knowledge-bases`

The workspace's knowledge bases: what each one holds (websites, files,
question/answer pairs) and which agents answer from it. An agent
answers from one base, named by `knowledge_base_id` on its campaign.
There is no cursor: a workspace has a handful of bases.
Requires scope `knowledge:read`.

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/knowledge-bases' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The workspace's knowledge bases

```json
{
  "data": [
    {
      "id": "68c1f1c4001a09be5d10",
      "name": "Salle Horizon",
      "campaign_ids": [
        "68c1f0a2003b6f1d2e77"
      ],
      "sources": {
        "websites": 1,
        "files": 2,
        "answers": 14
      },
      "created_at": "2026-09-02T09:19:48.000+00:00"
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listknowledgebases/
