update_conversation
Organise a DM thread: pin or unpin it, archive or restore it, set its tags, and/or mark it read. Omit what you don't want to change.
tags REPLACES the thread's whole tag list (read it first with
get_conversation and send the full list back) — up to 8 tags, each lowercased
with spaces turned into dashes and cut at 24 characters. The tag "hot-lead"
is what the inbox's "hot" filter shows. Archiving unpins. A new message from
the person brings an archived thread back by itself.
Nothing is sent to the person. Needs the DM permission (reeldrop:automations).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>",
"conversation_id": "<conversation_id>"
},
"name": "update_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| pinned | No | ||
| archived | No | ||
| mark_read | No | ||
| workspace_id | Yes | ||
| conversation_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| tab | Yes | ||
| name | No | ||
| tags | Yes | ||
| No | |||
| igsid | Yes | ||
| phone | No | ||
| pinned | Yes | ||
| archived | Yes | ||
| username | No | ||
| can_reply | Yes | ||
| unread_count | Yes | ||
| last_message_at | Yes | ||
| last_message_preview | Yes | ||
| reply_window_ends_at | No | ||
| last_message_direction | Yes |