The Create Knowledge Source endpoint ingests content into an agent's knowledge base. Exactly one of urls, file or plain_text must be provided per request. After creation, the source enters Pending status and is queued for ingestion.
api keyYour 7en API key. Example: Api-Key 43NKLN3LKN4nlkn
stringUse application/json for URL, plain_text, and Google Drive types. Use multipart/form-data for file uploads.
| Type | Field | Accepted Formats |
|---|---|---|
| URL | urls | Array of HTTP/HTTPS URLs |
| File upload | file | PDF, DOCX, TXT, CSV, XLSX |
| Plain text | plain_text | Free-form string |
intrequiredID of specific agent. example: `42`
stringrequiredTitle of knowledge source. example: `FAQ document`
stringrequiredText content for knowledge source. example: `This is knowledge document`
intrequiredID of specific agent. example: `42`
array of stringrequiredList of URLs to scrape and ingest. Example: ["https://help.acme.com/", "https://help.acme.com/faq"]
stringrequiredHuman-readable label for the knowledge source. Example: "Help Center"
intrequiredID of specific agent. example: `42`
filerequiredBinary file to upload. Supported formats: PDF, DOCX, TXT, CSV, XLSX. Max size: 10 MB. per upload.
stringrequiredHuman-readable label for the knowledge source. Example: "Product Manual v3"
urls, file, plain_text, or google_drive_file_id per request.Start building intelligent AI agents to engage with customers.