Soft-delete a workflow
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`.
/bot-workflows/{workflowId}Authorization
ApiKeyAuth An external API key, sent as Authorization: Bearer mflo_…. Scopes are checked per route; see each operation’s description.
In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/bot-workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "deleted": true }}Create a webhook endpoint POST
Returns the signing `secret` ONCE — store it before you close the response. The URL must be https and must resolve to a public address; private and link-local targets are rejected at save time. Default payload is core fields only; opt into PHI-bearing content blocks explicitly via `payloadConfig`. Limit: 20 endpoints per workspace. Required scope: `webhooks.manage`.
Get a workflow with its definition GET
Required scope: `bots.read`.