Mark where a thread stands
Marks an email thread open, waiting, handled or archived, and sets its labels.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Paul has his answer about the repair. Mark that conversation as handled and label it repairs.
Your agent callsemail_update_thread$0.001 a call
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"message_id": "6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04",
"state": "handled",
"labels": [
"repairs"
]
}Use it when
An email was answered or dealt with, so the next look at the inbox skips it.
- For a support request with its own status, owner and priority, use
ticket_update.
What it does
Mark an email thread open (needs a reply), waiting (on the other side), handled or archived, and set its labels, so you never reread or answer twice what you already dealt with: email_list_messages filters by state and label. A new message from outside opens a thread again. $0.001.
What comes back
The thread, its state and its labels. email_list_messages finds messages by both. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
message_idRequired | string | Any message of the thread. Exactly 36 characters. |
state | string | One of: open,waiting,handled,archived. |
labels | array of strings | Replaces the thread's labels. Up to 20 items. |
The call
Over MCP, call email_update_thread on https://api.conecto.chat/mcp/email. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/email_update_thread \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"message_id":"6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04","state":"handled","labels":["repairs"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No message of the business has that message_id. | Find the message with email_list_messages and use its message_id. |
invalid_input400 | Neither state nor labels was given, or the message came without a Message-ID, so it has no thread. | Give state, labels or both. |
More Email tools
All 10 tools- Create an inbox
email_create_inboxA new email address for the business on its own subdomain, which sends and receives at once.$1.00 a call - List inboxes
email_list_inboxesThe business's inboxes, whether each opens tickets or saves attachments, and when each renews.Free* - Change an inbox
email_update_inboxChanges an inbox's sender name, switches saving its attachments to the file store on or off, or changes how much it saves a day.$0.001 a call - Send an email
email_sendSends an email from one of the business's inboxes, with files from the store attached, or answers a received message in its thread.$0.001 to one person without attachments - List messages
email_list_messagesMessages in the business's inboxes, newest first: received, sent or both, for one inbox, one sender or since a time.Free* - Read a message
email_get_messageOne message in full: its text, HTML and attachment names.Free* - Read a thread
email_get_threadEvery message of one conversation, oldest first.Free* - Save an email's attachments
email_save_attachmentsSaves the files attached to one received email into the file store, each linked to the email.$0.001 per file saved
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md