POST
Create Kb

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required
max_pages
integer
default:1000
notes
string
default:""
urls
string[]

Response

Successful Response

The KB header — what the list view needs (no tree / curation detail).

created_at
string<date-time>
required
id
string<uuid>
required
name
string
required
status
enum<string>
required
Available options:
discovering,
review,
transcribing,
generating,
ready,
error
updated_at
string<date-time>
required
created_by
string<uuid> | null
error
string | null
node_count
integer | null
progress
KbProgress · object

Build-stage progress written to knowledge_bases.progress JSONB.

seeds
string[]
url_count
integer | null