Create a new document from a URL.
Usage
vf document create-url [flags]Examples
vf document create-url --project-id <id> --environment-alias <value> --url https://deserted-swordfish.info/Flags
--body string Request body as JSON (alternative to individual flags). Can also be provided via stdin.
-e, --environment-alias string [required]
-f, --folder-id string The ID of the Knowledge Base folder to file the document under. Without it, a new document starts at the top level and a document this overwrites keeps its folder; move one to the top level with 'folderID: null' on the document update. File names and URLs are unique across the whole Knowledge Base, not per folder, so an overwrite replaces the one document with that name or URL and, with 'folderID', moves it into this folder.
-h, --help help for create-url
--llm-based-chunks string JSON value (one of: boolean | StableDocumentController_createURL_llmBasedChunks_enum)
--llm-content-summarization string JSON value (one of: boolean | StableDocumentController_createURL_llmContentSummarization_enum)
--llm-generated-q string JSON value (one of: boolean | StableDocumentController_createURL_llmGeneratedQ_enum)
--llm-prepend-context string JSON value (one of: boolean | StableDocumentController_createURL_llmPrependContext_enum)
--markdown-conversion string JSON value (one of: boolean | StableDocumentController_createURL_markdownConversion_enum)
--max-chunk-size string JSON value (one of: string | number)
--metadata string Metadata tags attached to the document, used to filter knowledge base retrieval at runtime.
--overwrite string JSON value (one of: boolean | StableDocumentController_createURL_overwrite_enum)
-p, --project-id string [required]
-r, --refresh-rate string How often the URL is automatically re-crawled to refresh the document content. (options: daily, weekly, monthly, never)
-s, --single-chunk string JSON value (one of: boolean | StableDocumentController_createURL_singleChunk_enum)
-u, --url string The URL of the web page to crawl and ingest into the knowledge base. [required]Global flags
These flags are inherited from the parent command and work on every invocation.
--agent-mode Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDE_CODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
--color string Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
-d, --debug Log request and response diagnostics to stderr
--dry-run Preview the request that would be sent without executing it (output to stderr)
-H, --header stringArray Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
--include-headers Include HTTP response headers in the output
-q, --jq string Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
--no-interactive Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
-o, --output-format string Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
--server-url string Override the default server URL
--timeout string HTTP request timeout (e.g., 30s, 5m, 100ms)
--token string Voiceflow bearer token
--usage Print the CLI Usage schema in KDL formatSee also
- vf document - Operations for document