Rivier/ Reference/ content

A reader writes a comment

post/public/comments/{entryId}

A reader writes a comment. The form guard judges it: abuse is refused, anything unsure is held for a person.

Before you call

Credential
Authorization: Bearer $KEY
Scope
content:read
Sdk
content.readerComment.submit
Cli
content reader comment submit
Publishable
yes

Parameters

  • entryIdstring (uuid)required
    In the path

Request bodyapplication/json, required

  • namestringrequired
    At most 80 characters.
  • emailstring (email)
    At most 254 characters.
  • bodystringrequired
    At most 2000 characters.
  • parentIdstring (uuid)
  • tokenstring
    At most 2000 characters.
  • proofstring
    At most 64 characters.
  • shownMsinteger
    At least 0. At most 86400000.
  • honeypotstring
    At most 200 characters.

Responses

  • 202application/json
    Success
    • statusstringrequired
      One of: published, held.
  • 400application/json
    The request was malformed
    • errorstringrequired
    • messagestring
  • 401application/json
    No valid credential
    • errorstringrequired
    • messagestring
  • 403application/json
    The credential lacks the scope, origin or address
    • errorstringrequired
    • messagestring
  • 429application/json
    Over the key's rate limit; see Retry-After
    • errorstringrequired
    • messagestring

This page as Markdown