CLI Sources

Add, list, update, and delete knowledge sources for a Chatbase agent from the terminal.

Use source commands to manage an agent’s knowledge base — text, Q&A pairs, links, and file uploads. For REST details, see Sources API. Most commands require an agent ID (-a agt_123) or a default agent.

Add sources

Text snippet:

chatbase sources create --type text --name Guide --content "hello" -a agt_123

Website link (crawl mode):

chatbase sources create --type link --url https://example.com --link-type crawl -a agt_123

Q&A pair:

chatbase sources create --type qna --data '{"questions":["Q1"],"answer":"A1"}' -a agt_123

File upload:

chatbase sources create --file ./guide.pdf -a agt_123

Link types also include individual (single page) and sitemap.

List and inspect

List sources for an agent:

chatbase sources list -a agt_123

Show one source:

chatbase sources get src_123 -a agt_123

View aggregated counts and sizes:

chatbase sources summary -a agt_123

Update and delete

Update a text, Q&A, or link source:

chatbase sources update src_123 --data '{"type":"text","content":"updated"}' -a agt_123

Replace a file source:

chatbase sources update src_123 --file ./updated.pdf -a agt_123

Delete a source (restorable):

chatbase sources delete src_123 -a agt_123

Deletes are permanent. chatbase sources restore is deprecated and does nothing.

Changes take effect on their own

Every create, update, or delete trains the source right away. There is no train step. Check progress with:

chatbase sources get src_123 -a agt_123

The status field reads untrained while the source trains, trained once it is live (usually within seconds), or failed if the run did not land.

See CLI Agents for the auto-resync schedule.

Commands

Command	Purpose
chatbase sources create	Create a source: text/qna/link (JSON) or a file upload
chatbase sources delete	Permanently delete a source and its knowledge
chatbase sources get	Show one source
chatbase sources list	List sources for an agent
chatbase sources restore	Deprecated. Deletes are final; this command does nothing
chatbase sources summary	Show aggregated source counts and sizes for an agent
chatbase sources update	Update an existing source (text, qna, link, or file)

For every flag, run chatbase sources <command> --help.