# Chatbots

Publish automated chat flows that can answer, qualify, and hand over.

10 operations in the Chatbots resource group.

## Operations

- [List chatbots](/reference/chatbots/get-chatbots.md) - GET `/chatbots` - Returns chatbot drafts and active automations for the workspace.
- [Create chatbot](/reference/chatbots/create-chatbot.md) - POST `/chatbots` - Creates a chatbot draft that can later be published and activated.
- [Get chatbot](/reference/chatbots/get-chatbot.md) - GET `/chatbots/{id}` - Returns a chatbot draft, its status, and the active version when one is running.
- [Update chatbot](/reference/chatbots/update-chatbot.md) - PATCH `/chatbots/{id}` - Updates chatbot draft details or team assignments. Publish again to snapshot changes.
- [Delete chatbot](/reference/chatbots/delete-chatbot.md) - DELETE `/chatbots/{id}` - Deletes a chatbot. Active chatbots must be paused first.
- [Publish chatbot](/reference/chatbots/publish-chatbot.md) - POST `/chatbots/{id}/publish` - Validates and snapshots the current draft definition as an immutable version.
- [Activate chatbot](/reference/chatbots/activate-chatbot.md) - POST `/chatbots/{id}/activate` - Activates a chatbot. Requires a published version.
- [Pause chatbot](/reference/chatbots/pause-chatbot.md) - POST `/chatbots/{id}/pause` - Pauses an active chatbot.
- [List chatbot versions](/reference/chatbots/get-chatbot-versions.md) - GET `/chatbots/{id}/versions`
- [Get chatbot version](/reference/chatbots/get-chatbot-version.md) - GET `/chatbots/{id}/versions/{versionId}`

## Schemas

- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [WorkflowEdge](/reference/schemas/workflow-edge2.md) - object
- [Response](/reference/schemas/chatbots-response.md) - object
- [Chatbot](/reference/schemas/chatbot.md) - object - Automated chat flow that can serve selected teams or the whole workspace.
- [ChatbotStatus](/reference/schemas/chatbot-status.md) - enum
- [ChatbotWorkflowDefinition](/reference/schemas/chatbots-workflow-definition.md) - object
- [ChatbotWorkflowNode](/reference/schemas/chatbots-workflow-node.md) - object
- [ChatbotVersion](/reference/schemas/chatbot-version.md) - object
- [CreateChatbotRequest](/reference/schemas/create-chatbot-request.md) - object - Chatbot draft to create.
- [UpdateChatbotRequest](/reference/schemas/update-chatbot-request.md) - object - Chatbot draft fields to update.
- [ChatbotVersionsResponse](/reference/schemas/chatbot-versions-response.md) - object
