---
title: "Hide a comment"
method: POST
path: "/v1/inbox/comments/{postId}/{commentId}/hide"
tags: ["Inbox"]
---

# Hide a comment

`POST /v1/inbox/comments/{postId}/{commentId}/hide`

## Request

- Base URL: `https://api.postzen.dev`
- URL: `https://api.postzen.dev/v1/inbox/comments/{postId}/{commentId}/hide`
- Auth: HTTP bearer

Hides a comment so only its author still sees it. Requires a read-write API key and the account's comment-management scope. `canHide` on the comment says whether the platform allows it: Facebook reports it per comment, and Threads only supports hiding top-level replies on the connected account's own posts — hiding one there also hides the replies beneath it.

## Request body

- InboxHideRequest
  - `accountId` string, required: PostZen account id of the connected Instagram, Facebook, or Threads account that owns the post.

## Response `200`

Comment hidden.

- InboxHideResponse
  - `status` 'success', required
  - `commentId` string, required: Platform id of the comment.
  - `hidden` boolean, required: The comment's hidden state after the call.
  - `platform` 'instagram' | 'facebook' | 'threads', required: Platform the comment lives on.

## Other responses

- `400`: A parameter is missing or malformed — a plain `{ error }` body — or the account is not on a platform the inbox supports (`platformUnsupported`). A platform-rejected identifier or parameter also lands here, with `platformError` carrying the platform's wording.
- `401`: Missing or invalid API key.
- `403`: The API key is read-only, the account is outside its profile access (`forbidden`), or the connection is missing the account's comment-management scope (`platformCapabilityMissing`) — nothing is sent to the platform in that case.
- `404`: No such account (`accountNotFound`), no such post for that account (`postNotFound`), the PostZen post has not published to this account yet (`postNotPublished`), or the platform reported the comment as missing.
- `424`: The account's connection is dead and must be reauthorized before its comments can be read or written.
- `429`: The platform rate limited the upstream request; `platformError` carries its wording and `Retry-After` gives the wait in seconds. PostZen's own per-key and per-operation limiters also return `429`, with the plain body `{"error":"rate_limited","retryAfter":<seconds>}`.
- `500`: Unexpected server error.
- `502`: The platform could not answer the request. `platformError` carries its wording.

---

[API](https://skmtc.dev/postzen/apis/postzen-public-api.md) · [All operations](https://skmtc.dev/postzen/apis/postzen-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postzen/apis/postzen-public-api/revisions/40863e3710ec?raw)