v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Quickstart

Provision Docs Search

One-call provisioning of a complete documentation search pipeline. Creates a namespace, bucket, web crawl collection, retriever with semantic + code search, publishes it, and generates a scoped API key. Returns everything needed to embed the search widget.

post/v1/quickstart/docs-search

Request body

site_urlstring required

Root URL of the documentation site to crawl.

site_namestring required

Human-readable name for the docs site.

include_patternsstring[]

URL patterns to include (regex). Empty means include all.

exclude_patternsstring[]

URL patterns to exclude (regex).

namespace_idstring nullable

Existing namespace ID. If not provided, one will be created.

Example request

{
  "site_url": "https://docs.example.com",
  "site_name": "Example Docs",
  "include_patterns": [
    "/docs/.*",
    "/api/.*"
  ],
  "exclude_patterns": [
    "*/changelog/*",
    "*/blog/*"
  ]
}

Response

Successful Response

project_keystring required

Retriever-scoped API key (ret_sk_...) for widget authentication.

public_namestring required

Public retriever name for API access.

retriever_idstring required

ID of the created retriever.

collection_idstring required

ID of the web crawl collection.

batch_idstring nullable

ID of the crawl batch (if processing started).

namespace_idstring required

Namespace ID for all resources.

bucket_idstring required

Bucket ID where seed URLs are stored.

embed_snippetstring required

HTML snippet for drop-in integration.

react_snippetstring required

React component snippet.