Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

classify_thread

View as .md

Classify a conversation.

Adds or removes a conversation’s tags (labels replaces the whole list), archives or restores the thread, marks received messages as read or unread. Changes neither the messages, nor the blocks, nor their delivery status.

Access

  • Key: an Escouade Mail key with send or approve.
  • Space: any space, verified or not.
  • Changes nothing: no, it acts.
  • Safe to replay: yes.

Parameters

ParameterTypeRequiredDescription
thread_idstringyesConversation to classify.
labelslist of stringnoThe conversation’s tags: this list replaces the previous one.
archivedbooleannoArchive or restore.
readbooleannoMark as read or unread.

Call it

Terminal
curl -s https://api.subagent.fr/v1/classify_thread \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"thread_id": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/classify_thread.