---
title: "Redact a message"
method: POST
path: "/issues/{id}/messages/{message_id}/redact"
tags: ["messages"]
---

# Redact a message

`POST /issues/{id}/messages/{message_id}/redact`

Permanently redacts a message's content. This action cannot be undone.

**Rate limit:** 20 requests per minute

## Path parameters

- `id` string, required
- `message_id` string, required

## Response `200`

- RedactMessageResponseBody
  - `data` Message
    - `author` MessageAuthor
      - `avatar_url` string
      - `contact` MiniContact
        - `email` string — The email of the contact.
        - `id` string — The ID of the contact.
      - `name` string
      - `user` MiniUser
        - `email` string — The email of the user.
        - `id` string — The ID of the user.
    - `email_info` EmailMessageInfo
      - `bcc_emails` string[] — The email addresses of the BCC recipients of the message.
      - `cc_emails` string[] — The email addresses of the CC recipients of the message.
      - `from_email` string — The email address of the sender of the message.
      - `message_id` string — The RFC 5322 Message-ID header value for this email. This is a provider-specific identifier, not the top-level Pylon message ID, and cannot be used as message_id when posting a reply or internal note.
      - `to_emails` string[] — The email addresses of the recipients of the message.
    - `file_urls` string[] — The URLs of the files in the message, if any.
    - `id` string — The top-level Pylon message ID. Use this value as message_id when replying or when targeting an internal note's thread.
    - `is_private` boolean — Whether the message is an internal note. If true, the message is not visible to the requester; if false, it is customer-visible.
    - `message_html` string — The HTML body of the message.
    - `source` string — The source of the message.
    - `thread_id` string — The Pylon internal thread ID. This is set only for internal notes and can be passed as thread_id when creating an internal note.
    - `timestamp` string — The time at which the message was created.
  - `request_id` string — The request ID for tracking.

## Other responses

- `400` — The request was invalid or could not be completed.
- `404`
- `500` — An unexpected internal error occurred.

---

[API](https://skmtc.net/usepylon/apis/pylon-api.md) · [All operations](https://skmtc.net/usepylon/apis/pylon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usepylon/pylon-api/versions/999c51740b4e/schema)