---
title: "Redact Content in a Confluence Blog Post"
method: POST
path: "/blogposts/{id}/redact"
tags: ["Redactions"]
---

# Redact Content in a Confluence Blog Post

`POST /blogposts/{id}/redact`

Redacts sensitive content in a Confluence blog post by replacing specified text ranges with redaction markers. 
Each redaction in the response includes a unique UUID for restoration (except code block redactions). 
The response metadata items maintain the same order as the input redaction pointers, and completely 
overlapping redactions are merged into a single redaction with one UUID.

**Note**: This endpoint requires **Atlassian Guard Premium**.

## Path parameters

- `id` integer, required

## Request body

- object
  - `createdAt` string, date-time, required — Timestamp when the content was last updated.
  - `cleanHistory` boolean, nullable — Whether to clean up previous versions containing the redaction. When true, historical versions of the content that contain the redacted text will be squashed.
  - `versionNumber` integer, nullable — Optional version number of the content to redact. When specified, the redaction will target a specific historical version of the content rather than the current version. - If omitted or null, the redaction applies to the current (latest) version of the content. - When provided, must be a valid version number that exists for the content. **Note**: Version numbers start at 1 and increment with each content update.
  - `body` object
    - `redactions` RedactionPointer[]
      - `pointer` string, required — JSON pointer indicating the exact location within the content structure where redaction should be applied. Points to the text node containing the content to redact.
      - `from` integer — Starting character index (zero-based) within the target text where redaction begins.
      - `to` integer — Ending character index (zero-based) within the target text where redaction ends (exclusive). Must be greater than or equal to 'from' value.
      - `reason` string, nullable — Optional human-readable reason for the redaction. Used for audit trails and compliance documentation.
  - `title` object
    - `redactions` RedactionPointer[]
      - `pointer` string, required — JSON pointer indicating the exact location within the content structure where redaction should be applied. Points to the text node containing the content to redact.
      - `from` integer — Starting character index (zero-based) within the target text where redaction begins.
      - `to` integer — Ending character index (zero-based) within the target text where redaction ends (exclusive). Must be greater than or equal to 'from' value.
      - `reason` string, nullable — Optional human-readable reason for the redaction. Used for audit trails and compliance documentation.

## Response `202`

Redaction Accepted. The response contains details about the redactions that were applied.

- RedactionResponse — Response containing details of all redactions that were applied to the content. Each redaction includes a unique ID for restoration, except that code block redactions cannot be restored.
  - `body` RedactionSectionResponse
    - `redactions` RedactionPointerResponse[] — List of redactions that were applied to this section
      - `pointer` string — JSON pointer indicating where the redaction was applied
      - `from` integer — Starting character index where redaction was applied
      - `to` integer — Ending character index where redaction was applied
      - `reason` string — Reason for the redaction
      - `redactionId` string, uuid — Unique identifier for this redaction. Can be used to restore the redacted content later.
  - `title` RedactionSectionResponse
    - `redactions` RedactionPointerResponse[] — List of redactions that were applied to this section
      - `pointer` string — JSON pointer indicating where the redaction was applied
      - `from` integer — Starting character index where redaction was applied
      - `to` integer — Ending character index where redaction was applied
      - `reason` string — Reason for the redaction
      - `redactionId` string, uuid — Unique identifier for this redaction. Can be used to restore the redacted content later.

## Other responses

- `400` — Invalid request. This can be thrown if - createdAt field is out of date - JSON pointers are invalid

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/c4bd1ed570f2/schema)