Skip to main content
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 successful
boolean
Always false on success

Error Responses

boolean
false when an error occurs
string
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:
  1. Create a mid-call tool (for example transfer_to_human) with a webhook to ActivePieces or your automation flow.
  2. In the automation flow, call POST /automate/conversations/{uuid}/disable-ai with your API key.
  3. Notify your support team (for example via Slack, email, or CRM) including the conversation UUID.
  4. AI stops replying — your human agent takes over by sending messages directly.
To re-enable AI later, use the Enable AI endpoint.