Skip to content
RAG API

List knowledge bases

GET
/v1/knowledge-bases

List all knowledge bases for the authenticated account. Supports cursor-based pagination.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
cursor
string

Pagination cursor from a previous response’s meta.cursor field

limit
integer
>= 1

Maximum number of items to return per page

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Knowledge bases retrieved

object
data
required
Array<object>
object
id
required

Knowledge base ID (prefixed with kb_)

string
Example
kb_a1b2c3d4e5
account_id
required

Owning account ID

string
Example
acc_x9y8z7w6v5
name
required

Knowledge base name

string
Example
Product Documentation
description

Optional description

string
nullable
Example
All product docs and guides
metadata
required

Arbitrary JSON metadata

object
key
additional properties
any
Example
{
  "team": "engineering",
  "version": 3
}
document_count
required

Number of documents in this knowledge base

integer
Example
42
created_at
required
string format: date-time
Example
2026-02-10T12:00:00.000Z
updated_at
required
string format: date-time
Example
2026-02-10T14:30:00.000Z
meta
required
object
cursor
required

Cursor to pass for the next page. Null if no more results.

string
nullable
Example
eyJpZCI6ImtiX2FiYzEyMyJ9
has_more
required

Whether more results are available

boolean
Example
true

401

Section titled “401 ”

Authentication failed or missing

object
error
required
object
code
required

Machine-readable error code

string
Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR
Example
VALIDATION_ERROR
message
required

Human-readable error message

string
Example
Invalid request body
details

Additional error details (e.g., validation issues)

object
key
additional properties
any
Example
{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Invalid or missing API key"
  }
}

429

Section titled “429 ”

Rate limit exceeded

object
error
required
object
code
required

Machine-readable error code

string
Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR
Example
VALIDATION_ERROR
message
required

Human-readable error message

string
Example
Invalid request body
details

Additional error details (e.g., validation issues)

object
key
additional properties
any
Example
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  }
}