AgentKnowledge Bases

Create URL Document

Fetch a URL via Firecrawl and ingest the rendered content as a document. The fetch happens synchronously; expect a few seconds per page. Use the sitemap / crawl endpoints for multi-page imports.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Request

This endpoint expects an object.
urlstringRequiredformat: "uri"
folder_idstring or nullOptional

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

Response

The created document.
idstring
kb_idstring

Prefixed wire identifier (kb_<26 char Crockford base32>) of the knowledge base the document belongs to.

source_kindenum

How the document entered the KB. file is the upload path, text is inline pasted content, url is fetched via Firecrawl. Sitemap and crawl imports also produce url rows.

folder_idstring or null

Folder this document lives in. Null for root-level (unfiled) documents. Mutated via the move endpoint.

filenamestring
content_typestring
byte_sizelong
char_countinteger
chunk_countinteger
statusenum

Document lifecycle. fetching is the pre-scrape state used only by url-sourced rows; file and text docs skip straight to embedding because their content is available synchronously. Terminal states are ready and failed.

created_atdatetime
updated_atdatetime
source_urlstring

Source URL for url-sourced documents (and the sitemap / crawl imports that produce them). Empty string for file and text rows.

errorstring
Populated when status is failed.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error