REST APIKnowledge
Create a text or structured knowledge source
Indexing is triggered automatically. File uploads are Portal-only in v1 — this endpoint takes JSON, not multipart. Required scope: `knowledge.write`.
POST
/bots/{botId}/knowledge/sourcesAuthorization
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 POST "https://example.com/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/knowledge/sources" \ -H "Content-Type: application/json" \ -d '{ "type": "text", "title": "string" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "sourceType": "string", "articleType": "string", "usageMode": "string", "publishState": "string", "tags": [ "string" ], "category": "string", "lastVerifiedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "title": "string", "status": "string", "errorMessage": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}