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
The unique UUID identifier of the conversation
Response Fields
true when the operation was successfulAlways
false on successError Responses
false when an error occursError 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.

