Developers
Comments9

Delete a comment reply

DELETE/products/{product_id}/comments/{comment_id}/replies/{reply_id}

Deletes a single reply from a comment. The top-level comment and its other replies are not affected.

Only replies written by an administrator or an API credential (author.kind is admin or credential) can be deleted. Attempts to delete any other reply return 403 with the permission_denied error code and details[].field set to author.kind. To remove the entire conversation, delete the top-level comment instead.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

product_id*string

Public ID of the product, prefixed with prd_.

comment_id*string

Public ID of the comment, prefixed with cmt_.

reply_id*string

Public ID of the reply, prefixed with crp_.

Header Parameters

Idempotency-Key?string

Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Optional on this operation; when sent, a malformed key returns idempotency_key_invalid, and repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/products/string/comments/string/replies/string"
Empty

Update a comment reply PATCH

Updates the text or the moderation status of a comment reply. Only the text of replies written by an administrator or an API credential (`author.kind` is `admin` or `credential`) can be changed; attempts to edit the text of any other reply return `403` with the `permission_denied` error code and `details[].field` set to `author.kind`. Changing `status` requires the `comments.moderate` permission. To avoid overwriting a newer version, send the optional `If-Match` header built from the reply's `revision` field, in the format `W/"comment_reply:<reply_id>:<revision>"`. If the reply has changed since that revision, the update is rejected.

List comments for moderation GET

Lists top-level comments across all products accessible with the current credentials, for use as a moderation queue. When `status` is omitted, only comments with the `pending` status are returned. Results are paginated with a cursor and sorted by ID, newest first by default; use `sort=id` for oldest first.