REST APIKnowledge
Update the knowledge-base settings
Required scope: `knowledge.write`.
PATCH
/bots/{botId}/knowledgeAuthorization
ApiKeyAuth AuthorizationBearer <token>
An external API key, sent as Authorization: Bearer mflo_…. Scopes are checked per route; see each operation’s description.
In: header
Path Parameters
botId*string
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/knowledge" \ -H "Content-Type: application/json" \ -d '{ "enabled": true, "retrievalMode": "auto", "requireKnowledge": true, "maxCharacters": 200, "maxChunks": 1, "maxVectorDistance": 0, "searchDepth": 1, "timeoutMs": 1, "requiredTimeoutMs": 1 }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "isEnabled": true, "hasIndexedVersion": true, "settings": { "enabled": true, "retrievalMode": "auto", "requireKnowledge": true, "maxCharacters": 200, "maxChunks": 1, "maxVectorDistance": 0, "searchDepth": 1, "timeoutMs": 1, "requiredTimeoutMs": 1 }, "updatedAt": "2019-08-24T14:15:22Z" }}Update a knowledge source PATCH
A content change snapshots a revision and triggers reindexing; tag-only edits do neither. Required scope: `knowledge.write`.
Create a text or structured knowledge source POST
Indexing is triggered automatically. File uploads are Portal-only in v1 — this endpoint takes JSON, not multipart. Required scope: `knowledge.write`.