Skip to navigation

Add a knowledge source to a workstream

Add manual content, a UTF-8 text/Markdown file, a web page, a website or a WordPress website. LogicDialog imports and saves the source and documents together, preserving existing knowledge. Requires a workstream belonging to this workspace. Website import must be enabled by the administrator and may take up to a minute. Empty imports return 422 without saving a source. This operation does not publish: validate and apply the workstream, with knowledge enabled for the intended assistant.

Required permissions: workspace.edit. Connector sources are configured without immediately importing. Apply their settings to activate authenticated webhooks; use refresh or legacy migration to seed content. Enabling automatic publishing requires changes.approve and deploy.live or deploy.test.

Authentication

AuthorizationBearer

Kinde access token with the configured LogicDialog audience and workspace membership/permissions. Channel API keys cannot authenticate management operations.

Path parameters

workspaceIdstringRequired

Query parameters

branchstringOptional

Workstream or environment branch. Writes require a workstream; reads default to Live.

Request

This endpoint expects an object.
CreateKnowledgeSourceobjectRequired

Save one knowledge source in a workstream. Supply branch in the body, query, or X-LogicDialog-Branch header. This does not publish or change assistant attachment settings. HTTP request bodies default to a 1 MiB limit, including JSON overhead.

OR
KnowledgeConnectorInputobjectRequired

Response

Source saved in the workstream; not published

branchstring
sourceobject
publishedboolean
warningslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
413
Content Too Large Error
422
Unprocessable Entity Error