AI Chatbot
Disable AI
Disable AI replies for a specific conversation and hand over to a human
POST
Disables AI responses for a conversation. Once disabled, the assistant will stop generating replies — new messages in the conversation are still stored but not answered by AI.
This is useful for human takeover workflows: trigger this endpoint when a customer asks to speak with a human agent.
Authentication
This endpoint requires your Automate API key as a Bearer token.Path Parameters
string
required
The unique UUID identifier of the conversation
Response Fields
boolean
true when the operation was successfulboolean
Always
false on successError Responses
boolean
false when an error occursstring
Error message. Possible values:
Conversation not found— the UUID does not exist or belongs to a different account
Human Takeover Flow
A common handover pattern:- Create a mid-call tool (for example
transfer_to_human) with a webhook to ActivePieces or your automation flow. - In the automation flow, call
POST /automate/conversations/{uuid}/disable-aiwith your API key. - Notify your support team (for example via Slack, email, or CRM) including the conversation UUID.
- AI stops replying — your human agent takes over by sending messages directly.