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.

Staff replies are deleted without removing the top-level comment. A student reply can also be deleted individually when the credentials have comments.delete; the rest of the thread is kept.

Authorization

AuthorizationBearer <token>

Credential: 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

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 comments and pending replies 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.