Knowledge Bases

Add source

Add a document, URL, YouTube video, or scraped site to a base.

Endpoint

POST https://api.strideops.ai/v1/bases/{baseId}/sources

Adds a source. Processing happens asynchronously - poll Get source or subscribe to webhooks.

Path parameters

ParamTypeNotes
baseIduuidKnowledge base id.

Request body

FieldTypeRequiredNotes
namestringyesHuman-readable label.
typeenumyes"file" | "url" | "youtube" | "scrape".
urlstringconditionalRequired for url, youtube, scrape.
storageUrlstringconditionalRequired for file. Use the dashboard's upload flow to get one.
ragSettingsOverrideobjectnoPer-source overrides. See Bases overview.

Response

{
  "id": "src_…",
  "baseId": "kb_…",
  "name": "Acme Engineering Handbook",
  "type": "url",
  "url": "https://example.com/handbook.pdf",
  "status": "processing",
  "createdAt": "2026-05-25T20:14:00Z"
}

Example

curl -X POST https://api.strideops.ai/v1/bases/kb_8f3e…/sources \
  -H "Authorization: Bearer $STRIDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Engineering Handbook",
    "type": "url",
    "url":  "https://example.com/handbook.pdf"
  }'

On this page