---
title: "Moderate an inbox message"
method: POST
path: "/v1/workspaces/{workspaceId}/inbox/messages/{messageId}/moderate"
tags: ["Inbox"]
---

# Moderate an inbox message

`POST /v1/workspaces/{workspaceId}/inbox/messages/{messageId}/moderate`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/inbox/messages/{messageId}/moderate`
- Auth: HTTP bearer

## Path parameters

- `messageId` string, required
- `workspaceId` string, uuid, required

## Request body

- ModerateMessageDto
  - `action` 'hide' | 'unhide' | 'delete', required

## Response `200`

Inbox message moderated

- object
  - `data` PublicInboxMessageDto, required
    - `id` string, uuid, required
    - `parentMessageId` string, uuid, nullable, required
    - `direction` 'incoming' | 'outgoing' | 'internal_note', required
    - `content` string, required
    - `author` PublicInboxAuthorDto, required
      - `name` string, nullable, required
      - `handle` string, nullable, required
      - `avatarUrl` string, nullable, required
      - `isExternal` boolean, required
    - `isHidden` boolean, required
    - `isDeleted` boolean, required
    - `isResolved` boolean, required
    - `resolvedAt` string, nullable, required
    - `resolvedBy` PublicInboxResolvedByDto, required
      - `id` string, uuid, required
      - `name` string, required
      - `initials` string, required
    - `resolvedReason` string, nullable, required
    - `resolvedNote` string, nullable, required
    - `sentByUserId` string, uuid, nullable, required
    - `sendStatus` 'sending' | 'sent' | 'failed', nullable, required
    - `sendError` string, nullable, required
    - `capabilities` PublicInboxPartialCapabilitiesDto
      - `canReply` boolean
      - `canHide` boolean
      - `canDelete` boolean
      - `canAttachMedia` boolean
    - `attachments` PublicInboxAttachmentDto[], required
      - `type` string, required
      - `url` string, required
    - `conversationMedia` PublicConversationMediaDto[], required
      - `id` string, uuid, required
      - `url` string, required
      - `thumbnailUrl` string, nullable, required
      - `type` string, required
    - `platformCreatedAt` string, nullable, required
    - `createdAt` string, nullable, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)
