Inbox 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 and does not apply to YouTube.

Billing: Request; paid actions are priced in credits (see GET /v1/messaging/prices) · Rate limit: 60/min

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

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/inbox/comments/{postId}/{commentId}/moderation
  • Auth: HTTP bearer

Path parameters

postIdstring required
commentIdstring required

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

platform'youtube' required

Only YouTube supports comment moderation

accountIdstring required

The account ID

banAuthorboolean

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

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

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

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.