Mediflo
REST APIWorkflows

Make this the bot’s active workflow

Atomically deactivates any other workflow on the same bot. Refuses to activate a definition that fails validation, or one whose node `skillRef` the bot would not serve — 400 `BOT_WORKFLOW_SKILL_REF_NOT_SERVABLE` with `details.skillRefs`. Activation re-checks the pins even when the graph has not changed, because the bot’s snapshot may have moved since it was saved. Required scope: `bots.write`.

POST/bot-workflows/{workflowId}/activate

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
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/bot-workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08/activate"
{  "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"  }}

Validate a workflow definition without saving POST

Stateless. Always 200 when the request is well-formed — the verdict is in `valid`. Iterate until `valid` is true, then create or update. Required scope: `bots.read`.

Return the bot to prompt-only mode POST

Clears the active flag without deleting the workflow, so it can be reactivated later. Idempotent — deactivating an already-inactive workflow succeeds with `wasActive: false`. Takes effect on the next call. Required scope: `bots.write`.