Skip to navigation

Receive a knowledge change

Authenticates a deployed source token and durably queues the event before returning HTTP 200. No publishing occurs in the request. Preserve the WordPress post_id/post_type/post_url, Umbraco Id/CreateDate/Properties, or Power Automate filename/file.$content payload. Knowledge API sources accept JSON document upserts using a source article ID from meta.description.id, id or externalId (_id is a last fallback). DELETE supports Power Automate filenames and Knowledge API document IDs. Retries with an Idempotency-Key must use identical payloads; receipts are retained for 30 days. Without that header, only consecutive identical events are deduplicated. Processing requires the knowledge worker.

Authentication

AuthorizationBearer

Source-specific webhook token shown when configuring the knowledge source; activated only after deployment.

Path parameters

workspaceIdstringRequired
environmentstringRequired
sourceKeystringRequired

Headers

Idempotency-KeystringOptional<=200 characters

Request

This endpoint expects a map from strings to any.

Response

Event persisted; may already have been accepted

acceptedbooleanOptional
idstringOptional
duplicatebooleanOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
503
Service Unavailable Error