Mediflo
REST APIWorkflows

Validate a workflow definition without saving

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`.

POST/bot-workflows/validate

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

Request 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/bot-workflows/validate" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "valid": true,    "issues": [      {        "kind": "string",        "nodeId": "string",        "field": "string",        "message": "string"      }    ]  }}

List a bot’s conversation workflows GET

Required scope: `bots.read`.

Make this the bot’s active workflow POST

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`.