Sign in
conversations

Update Conversation Agent Toggle

Toggle the SMS agent on or off for a specific conversation.

When disabled, the agent will still run in shadow mode (logs to sms_agent_shadow_logs) but will not send SMS or execute tools.

The updated state is broadcast via Supabase Realtime, allowing both dashboard and mobile clients to sync in real-time.

patch/conversations/{conversation_id}/agent-toggle

Path parameters

conversation_idstring uuid required

Request body

enabledboolean required
updated_bystring required

Source of the toggle action: 'dashboard' or 'mobile'

user_namestring nullable

Display name of the user performing the toggle, for activity log attribution

disable_reasonstring nullable

Free-text reason captured when a technician disables AI Reply. Stored on the agent_toggle timeline event metadata as feedback.

Response

Successful Response

conversation_idstring uuid required
enabledboolean required
status_messagestring nullable
updated_atstring date-time nullable
updated_bystring nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.