---
title: "Perform actions on an individual message"
method: POST
path: "/v0/messages/{id}/actions"
tags: ["Messages"]
---

# Perform actions on an individual message

`POST /v0/messages/{id}/actions`

Perform actions (trash, restore, quarantine, warning banner, move to spam) on an individual message

## Path parameters

- `id` string, uuid, required — ID of the message to act on

## Request body

- ActionMessageInput
  - `action` 'restore' | 'warning_banner' | 'quarantine' | 'trash' | 'move_to_spam' | 'move_to_graymail' | 'delete_calendar_events' — Action to take on the message group
  - `custom_action_ids` string[] — IDs of actions to perform on the message group
  - `share_with_sublime` boolean — Whether to share the message group & review with Sublime

## 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/versions/d5df82850357/schema)
