Patch a Conversation

Update a single conversation. The Conversations UI uses

PATCH

for status, human/AI assignment, pipeline stage, AI context cut, unread count, auto-assignment flags, blocking, and assigning the thread to the current user when sending a message with “takeover”.

Endpoint

PATCH

/conversations/:id

Request examples

Open or close

Assign human owner

Unassign human:

Assign AI assistant

Move pipeline / stage

Clear stage (and pipeline when clearing in the app):

Cut AI context (forget prior messages for the assistant)

Mark unread / mark read (unread count)

Mark as unread (app sets count to 1):

Mark as read (app sets to 0 when the message list loads):

Toggle AI auto-assignment

Disable:

Re-enable:

Block / unblock conversation

Patchable fields (from app usage)

Field	Type	Description
`status`	String	`open` or `closed`.
`assigned_user_id`	Number or null	Human assignee.
`assigned_ai_assistant_id`	String, number, or null	AI assistant id or unassign.
`pipeline_id`	Number or null	Pipeline when setting or clearing stage.
`pipeline_stage_id`	Number or null	Stage id.
`ai_context_cut`	String (ISO 8601)	Start of window for AI context.
`unread_count`	Number	Unread badge count.
`ai_auto_assignment_disabled`	Boolean	Disables automatic AI assignment rules for this thread.
`ai_auto_assignment_disabled_reason`	String or null	Stored reason when disabled.
`blocked`	Boolean	Block state for the conversation.

Response

Returns the updated conversation object (same shape as Get a conversation).

Report an issue with this documentation

Please log in to report issues with our documentation.