Voice AgentsKnowledge Bases

Create Multi-URL Import

Kick off an async multi-URL import. Accepts 1..N URLs in a single job (capped per-deployment, default 50) and runs the same per-URL pipeline as the sitemap worker. Returns 202 with the import job row; client polls GET /{id}/imports for progress.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired

Request

This endpoint expects an object.
urlslist of stringsRequired
folder_idstring or nullOptional

Folder to import the documents into. Prefixed wire identifier (kfolder_<26 char Crockford base32>); null/omitted = root.

Response

Import job queued.
jobobject

Async URL import job (AIS-2655 sitemap, AIS-2657 crawl, plus the auto-refresh path). The console polls GET /v1/agents/knowledge-bases/{id}/imports while the job is non-terminal.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error