Mediflo
REST APIBot configuration

Get the draft configuration

Required scope: `bots.read`.

GET/bots/{botId}/config

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

botId*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/config"
{  "data": {    "botId": "58ed41f0-04bf-402f-9853-7143ef7dd5ce",    "updatedAt": "2019-08-24T14:15:22Z",    "agentPromptText": "string",    "remarksPromptText": "string",    "remarksLlmModelId": "61dba459-df9c-4002-a591-7e86bec83d9b",    "remarksFallbackLlmModelIds": [      "25cd54b2-ac54-4f0d-8bb9-3cdcb88f159c"    ],    "remarksTemperature": 0,    "remarksOutputSchemaJson": null,    "toolsConfig": null,    "guardrailsConfig": null,    "greetingConfig": null,    "channelSettings": null,    "sessionInitConfig": null,    "turnTakingMode": "string",    "promptVariableMetadata": null,    "modelConfig": null,    "currentConfigSnapshotId": "c9e4146c-56e5-412d-a7c1-86311b72b35e",    "entryProcedureId": "2fd6edee-ae37-4588-8083-09bfb58841c3"  }}

List published configuration versions GET

Required scope: `bots.read`.

Edit the draft configuration PATCH

Send `expectedUpdatedAt` (the `updatedAt` you last read) for optimistic concurrency; a mismatch returns 409 with the authoritative config unless `forceOverwrite` is set. Editing the draft does NOT affect live calls until you publish. The bot’s models are configured by Mediflo and are not part of this body; a model change from a key without a Mediflo staff member’s authority is refused with 403 `BOT_MODEL_CONFIG_STAFF_ONLY`. Required scope: `bots.write`.