Upload documents

The Source settings tab of a bot is where its knowledge base lives. Adding documents here, then training, is how the bot learns. Documents persist until you delete them — they survive between trainings.

Supported formats#

Maximum 20 MB per file. Each plan also caps total document storage per bot.

How to upload#

1. Open the bot detail page

   Click the bot's card on the Dashboard.

2. Switch to Source settings

   The tab is at the top of the page.

3. Drag files into the upload zone

   Or click Upload more documents to pick from your file browser. Multi-select works.

4. Wait for processing

   Pegasus shows "Uploading..." then "Document uploaded successfully." Failed uploads are reported individually.

Source settings tab with knowledge base section

Files skipped automatically#

Pegasus may skip files during a batch upload. The reasons are reported with a toast:

• "File is too large. Maximum size is 20MB." — single file over the per-file cap.
• " files were skipped (over 20MB)." — multiple files in a batch over the cap.
• " files were skipped because they exceed the remaining storage." — the bot has used most of its per-plan storage; some files in the batch don't fit.

Other files in the same batch are uploaded normally.

After uploading#

Uploaded files appear in the Documents list with their size and a delete button. The bot status switches to UNTRAINED (or OUTDATED if the bot was previously READY). You now need to train the bot for it to use the new content.

Deleting documents#

Click the trash icon next to a file. Pegasus asks for confirmation. After deletion, the bot's status moves to OUTDATED (if it was READY) — retrain to make the bot forget that content.

Storage limits#

When you're close to the cap, Pegasus shows " remaining." When the cap is hit you see "Document storage limit reached for this bot."

See Storage limit reached for what to do.