Skip to content
Dashboard

List knowledge bases

GET
/knowledge-bases
curl --request GET \
--url https://app.whatsetter.com/api/v1/knowledge-bases \
--header 'Authorization: Bearer <token>'

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.

The workspace’s knowledge bases

Media typeapplication/json
object
data
Array<object>
object
id
string
name
string | null
campaign_ids

The agents that answer from this base (the id of GET /campaigns).

Array<string>
sources
object
websites
integer
files
integer
answers
integer
created_at
string format: date-time
Example
{
"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"
}
]
}

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

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)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}