Chatbots
Publish automated chat flows that can answer, qualify, and hand over. 10 endpoints in this resource.
List chatbots
https://api.flownally.com/v1/chatbotsReturns the workspace's chatbots, newest first.
Open as its own pageAuthorization
- journey:list
- owner
- admin
- agent
List chatbots in the workspace.
Parameters
- Name
pageSize- Type
- query · integer
Values above 100 are reduced to 100; 0 or omitted uses the default (50).- Name
pageToken- Type
- query · string
Responses
- 200List of chatbotsapplication/json
- defaultErrorapplication/json
Related schemas
curl "https://api.flownally.com/v1/chatbots" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"chatbots": [
{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}
],
"nextPageToken": "string",
"totalSize": 0
}Create chatbot
https://api.flownally.com/v1/chatbotsCreates a chatbot draft. Publish and activate it before it serves conversations.
Open as its own pageAuthorization
- journey:create
- owner
- admin
- agent
Create a chatbot in the workspace.
Body parameters
Send a application/json body. The body is required.
- Name
name- Type
- string
- required
- Name
teamIds- Type
- array<string>
Teams the chatbot serves. Omit or leave empty to make it the workspace-wide chatbot.- Name
draft- Type
- ChatbotWorkflowDefinition
Responses
- 201Chatbot createdapplication/json
- defaultErrorapplication/json
Related schemas
curl -X POST "https://api.flownally.com/v1/chatbots" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Support triage",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
]
}'{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}Get chatbot
https://api.flownally.com/v1/chatbots/{id}Returns a chatbot with its draft, its status and, while it is active, the active version.
Open as its own pageAuthorization
- journey:read
- owner
- admin
- agent
Read a chatbot in the workspace.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Responses
- 200Chatbot detailsapplication/json
- defaultErrorapplication/json
Related schemas
curl "https://api.flownally.com/v1/chatbots/$CHATBOT_ID" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}Update chatbot
https://api.flownally.com/v1/chatbots/{id}Updates a chatbot's name, teams or draft. A new name or teamIds applies at once.
Changes to draft reach conversations only after you publish and activate the chatbot
again.Changing the teams of an active chatbot fails with 422 and code
messaging_chatbot_route_conflict when another active chatbot already serves one of the
new teams, or, when no teams remain, the whole workspace.
Authorization
- journey:update
- owner
- admin
- agent
Update a chatbot in the workspace.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Body parameters
Send a application/json body. The body is required.
- Name
name- Type
- string
- Name
teamIds- Type
- array<string>
Replaces all of the chatbot's teams. Omit to keep them; pass an empty array to make it the workspace-wide chatbot.- Name
draft- Type
- ChatbotWorkflowDefinition
Responses
- 200Chatbot updatedapplication/json
- defaultErrorapplication/json
Related schemas
curl -X PATCH "https://api.flownally.com/v1/chatbots/$CHATBOT_ID" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "order_ready",
"teamIds": [
"string"
],
"draft": {
"nodes": [
{
"id": "string",
"type": "string",
"data": {}
}
],
"edges": [
{
"id": "string",
"source": "string",
"target": "string",
"sourceHandle": "string",
"value": "string",
"targetHandle": "string",
"data": {}
}
]
}
}'{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}Delete chatbot
https://api.flownally.com/v1/chatbots/{id}Deletes a chatbot. Pause an active chatbot before you delete it.
Open as its own pageAuthorization
- journey:delete
- owner
- admin
- agent
Delete a chatbot in the workspace.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Responses
- 204Chatbot deleted
- defaultErrorapplication/json
Related schemas
curl -X DELETE "https://api.flownally.com/v1/chatbots/$CHATBOT_ID" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"Publish chatbot
https://api.flownally.com/v1/chatbots/{id}:publishValidates the draft and saves it as a new read-only version. Every call creates a new
version, even when the draft hasn't changed.Publishing doesn't change what runs: activate the chatbot to use the new version. An
invalid draft fails with 400, and detail says what to fix.
Authorization
- journey:publish
- owner
- admin
- agent
Publish a chatbot version.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Responses
- 200Version publishedapplication/json
- defaultErrorapplication/json
Related schemas
curl -X POST "https://api.flownally.com/v1/chatbots/$CHATBOT_ID:publish" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"id": "string",
"chatbotId": "string",
"definition": {
"nodes": [
{
"id": "string",
"type": "string",
"data": {}
}
],
"edges": [
{
"id": "string",
"source": "string",
"target": "string",
"sourceHandle": "string",
"value": "string",
"targetHandle": "string",
"data": {}
}
]
},
"createdAt": "2026-04-27T00:00:00.000Z",
"updatedAt": "2026-04-27T00:00:00.000Z"
}Activate chatbot
https://api.flownally.com/v1/chatbots/{id}:activateMakes the latest published version active, so the chatbot serves its teams, or the whole workspace when it has no teams. On an active chatbot, the latest version replaces the active one.
- Fails with
422and codemessaging_chatbot_route_conflictwhile another active chatbot already serves one of its teams or, for a chatbot without teams, the whole workspace. Pause that chatbot first. - Fails with
422and codemessaging_chatbot_no_published_versionuntil the chatbot is published.
Authorization
- journey:activate
- owner
- admin
- agent
Activate a chatbot.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Responses
- 200Chatbot activatedapplication/json
- defaultErrorapplication/json
Related schemas
curl -X POST "https://api.flownally.com/v1/chatbots/$CHATBOT_ID:activate" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}Pause chatbot
https://api.flownally.com/v1/chatbots/{id}:pausePauses an active chatbot, so another chatbot can be activated for its teams or the whole
workspace. Activate the chatbot again to resume.Fails with 422 and code messaging_chatbot_not_active when the chatbot isn't active.
Authorization
- journey:activate
- owner
- admin
- agent
Pause a chatbot.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.
Responses
- 200Chatbot pausedapplication/json
- defaultErrorapplication/json
Related schemas
curl -X POST "https://api.flownally.com/v1/chatbots/$CHATBOT_ID:pause" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"id": "cbt_d7piv2pmo0bkvp4lmeh0",
"name": "Support triage",
"status": "draft",
"teamIds": [
"tem_d7pi77577990sq67vgqg"
],
"createdAt": "2026-04-30T10:00:00Z",
"updatedAt": "2026-04-30T10:12:00Z"
}List chatbot versions
https://api.flownally.com/v1/chatbots/{id}/versionsReturns a chatbot's published versions, newest first.
Open as its own pageAuthorization
- journey:read
- owner
- admin
- agent
List chatbot versions.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.- Name
pageSize- Type
- query · integer
Values above 100 are reduced to 100; 0 or omitted uses the default (50).- Name
pageToken- Type
- query · string
Responses
- 200List of versionsapplication/json
- defaultErrorapplication/json
Related schemas
curl "https://api.flownally.com/v1/chatbots/$CHATBOT_ID/versions" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"chatbotVersions": [
{
"id": "string",
"chatbotId": "string",
"definition": {
"nodes": [
{
"id": "string",
"type": "string",
"data": {}
}
],
"edges": [
{
"id": "string",
"source": "string",
"target": "string",
"sourceHandle": "string",
"value": "string",
"targetHandle": "string",
"data": {}
}
]
},
"createdAt": "2026-04-27T00:00:00.000Z",
"updatedAt": "2026-04-27T00:00:00.000Z"
}
],
"nextPageToken": "string",
"totalSize": 0
}Get chatbot version
https://api.flownally.com/v1/chatbots/{id}/versions/{versionId}Returns a published version of a chatbot.
Open as its own pageAuthorization
- journey:read
- owner
- admin
- agent
Read a chatbot version.
Parameters
- Name
id- Type
- path · string
- required
Chatbot ID.- Name
versionId- Type
- path · string
- required
Chatbot version ID.
Responses
- 200Version detailsapplication/json
- defaultErrorapplication/json
Related schemas
curl "https://api.flownally.com/v1/chatbots/$CHATBOT_ID/versions/$VERSION_ID" \
-H "Authorization: Bearer $FLOWNALLY_API_TOKEN"{
"id": "string",
"chatbotId": "string",
"definition": {
"nodes": [
{
"id": "string",
"type": "string",
"data": {}
}
],
"edges": [
{
"id": "string",
"source": "string",
"target": "string",
"sourceHandle": "string",
"value": "string",
"targetHandle": "string",
"data": {}
}
]
},
"createdAt": "2026-04-27T00:00:00.000Z",
"updatedAt": "2026-04-27T00:00:00.000Z"
}