---
title: "Trash message group"
method: POST
path: "/v0/message-groups/{id}/trash"
tags: ["Message Groups"]
---

# Trash message group

`POST /v0/message-groups/{id}/trash`

Trash all messages in a group, including future messages. For an Office 365 message source, each message will be moved to the "Recoverable Items" folder. For a Google Workspace message source, the "Trash" label will be added to each message.

## Path parameters

- `id` string, required — Canonical ID of the message group to trash

## Request body

- TrashMessageCanonicalGroupInput
  - `classification` 'malicious' | 'benign' | 'spam' | 'graymail' | 'simulation' | 'unwanted' | 'violation' | 'non-violation' — Classification to apply to the messages being reviewed. Optional.
  - `report_label` 'spam' | 'phishing' | 'false_positive' | 'false_negative' | 'phishing_simulation' | 'graymail' | 'violation' | 'non-violation' — Label to apply to messages being reviewed. Optional.
  - `review_comment` string, nullable — Comment describing reason for action

## Response `202`

Accepted

- HandlerTypesTaskAccepted
  - `task_id` string, uuid, required — Task ID. Use the /v0/tasks/:id endpoint to check the task status.

---

[API](https://skmtc.net/sublime/apis/sublime-platform-api.md) · [All operations](https://skmtc.net/sublime/apis/sublime-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sublime/sublime-platform-api/revisions/d5df82850357/schema)
