Knowledge Bases
POST Add source
Add a document, URL, YouTube video, or scraped site to a base.
Endpoint
POST https://api.strideops.ai/v1/bases/{baseId}/sourcesAdds a source. Processing happens asynchronously - poll Get source or subscribe to webhooks.
Path parameters
| Param | Type | Notes |
|---|---|---|
baseId | uuid | Knowledge base id. |
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
name | string | yes | Human-readable label. |
type | enum | yes | "file" | "url" | "youtube" | "scrape". |
url | string | conditional | Required for url, youtube, scrape. |
storageUrl | string | conditional | Required for file. Use the dashboard's upload flow to get one. |
ragSettingsOverride | object | no | Per-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"
}'