Add a knowledge source (file as base64, URL, text or FAQ)

Same quota, credit check, URL safety and file checks as the dashboard. Processing runs in the background; the response carries the job to poll at GET /api/v1/jobs/{jobId}.

post/api/v1/chatbots/{id}/knowledge/sources

Request

  • Base URL: https://smartwebchat.eu
  • URL: https://smartwebchat.eu/api/v1/chatbots/{id}/knowledge/sources
  • Auth: HTTP bearer

Path parameters

idstring required

Chatbot ID

Headers

Idempotency-Keystring

Optional. Choose a unique value per intended creation and send it again on every retry of that same request: the API then returns the stored first response, marked Idempotency-Replayed: true, instead of creating a second resource. Stored for 24 hours per account and route. The request body is compared byte for byte: the same key with a different body (even a different key order) gives 422. The same key while the first request is still running gives 409 with Retry-After. 5xx responses are not stored; the key is released. POST /api/v1/chatbots/{id}/chat accepts the header only with stream: false — with stream: true (the default) it answers 400 before anything is stored.

Request body

OR
OR
OR

Response

Source accepted; data.source and data.job

Changes

No recorded changes to this operation across all 1 revision of this API.