v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Comments

Set comment moderation status

Set a comment's moderation status. Supported on YouTube only.

Use this to work a moderation queue: approve a held comment (published), reject it (rejected), or send it back for review (heldForReview).

The request must be authorized by the owner of the channel or video the comment belongs to. You cannot moderate comments on videos you do not own.

This is distinct from POST /v1/inbox/comments/{postId}/{commentId}/hide, which covers Facebook, Instagram, Threads, and X/Twitter and does not apply to YouTube.

post/v1/inbox/comments/{postId}/{commentId}/moderation

Path parameters

postIdstring required

commentIdstring required

Request body

accountIdstring required

The social account ID

platform'youtube' required

Only YouTube supports comment moderation

moderationStatus'published' | 'rejected' | 'heldForReview' required

published approves the comment, rejected removes it, heldForReview returns it to the queue.

banAuthorboolean

Also ban the comment's author, auto-rejecting their future comments. Only valid when moderationStatus is "rejected"; any other pairing is a 400.

Response

Moderation status applied

successboolean