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

uuid
string
required
The unique UUID identifier of the conversation

Response Fields

status
boolean
true when the operation was successful
ai_enabled
boolean
Always false on success

Error Responses

status
boolean
false when an error occurs
error
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.