Skip to main content
POST
/
api
/
automate
/
conversations
/
{uuid}
/
disable-ai
curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "status": true,
  "ai_enabled": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.famulor.io/llms.txt

Use this file to discover all available pages before exploring further.

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
curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "status": true,
  "ai_enabled": false
}

​
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.