Knowledge base - OnDial API

Knowledge bases power agent answers during calls and messaging. You can manage documents via Public API v1 or the dashboard.

Public API (v1)

Requires scopes knowledge:read (list, metadata, billing preview) and knowledge:write (upload, delete). Request these when your API key is approved.

Action	Endpoint
List documents	`GET /api/v1/knowledge-bases/documents`
Upload	`POST /api/v1/knowledge-bases/documents` (multipart `file`)
Metadata	`GET /api/v1/knowledge-bases/documents/{fileId}`
Delete	`DELETE /api/v1/knowledge-bases/documents/{fileId}`
Billing preview	`GET /api/v1/knowledge-bases/upload-billing-info`

Supported file types: PDF, Word, Excel, TXT (max 50MB). Security: v1 returns metadata only — no file bytes and no download URL. Live keys may debit credits on upload when billing is enabled; sandbox keys skip debit.

Linking to agents

After upload, attach documents to inbound agents or campaigns in the dashboard (or via a future inbound-agent PATCH). Store fileId and knowledgebaseId from the upload response for your records. See Upload document and Healthcare HMS integration.