Create source
Creates a Knowledge Hub source from a URL. Text extraction runs
asynchronously, so the source is returned with status: pending or
processing; poll the detail endpoint until status is ready.
URL sources are de-duplicated within the workspace: if the URL already
exists, the existing source is returned with status 200 instead of
201.
File upload via the REST API is not yet supported — use URL ingest.
Authorizations
API key created in Settings > API.
Format: exec_live_ followed by 40 alphanumeric characters.
Body
Source type. Only url is supported via the REST API today.
url Display title for the source
The URL to ingest (required when type is url)
Optional cover image reference
UUIDs of folders to place the source in
Response
An existing source with the same URL was returned (de-duplicated)
A Knowledge Hub source — an uploaded file or ingested URL whose text is extracted and indexed.
Unique source identifier (UUID)
Source title
Where the source came from
upload, url, notion, google_drive, guru, page, integration Text-extraction status
pending, processing, ready, failed Format of the extracted content
markdown, plain_text, image, video Number of tokens in the extracted text
Whether the source contains images
Original URL for url/notion/guru/google_drive sources (null otherwise)
AI-generated summary of the source
Cover image reference (empty string if none)
Folders the source belongs to
User who added the source
When extraction finished
Extracted text (only included when requested via ?include=content)