REST APIWorkflows
Get a workflow with its definition
Required scope: `bots.read`.
GET
/bot-workflows/{workflowId}Authorization
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
workflowId*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/bot-workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "botId": "58ed41f0-04bf-402f-9853-7143ef7dd5ce", "name": "string", "description": "string", "version": 0, "isActive": true, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "definition": null }}Soft-delete a workflow DELETE
Deleting the ACTIVE workflow is allowed: it is deactivated and soft-deleted in one step, returning the bot to prompt-only mode. The workflow disappears from every list and cannot be reactivated. Required scope: `bots.write`.
List a bot’s conversation workflows GET
Required scope: `bots.read`.