Comment on a change
Write a comment under a change, for everybody or for the administrators only.
Markup is stripped from the comment. Every comment waits for an administrator to review it, and a public one is shown to everybody in the meantime. An administrator may hide a public comment, after which only its author reads it.
A comment that is missing or longer than 2,000 characters answers 422 on body.
Parameters
Sent as JSON. Anything not listed here is ignored.
The identifier of the change, the 26 characters it reports as id. A change that does not exist or is not published yet answers 404.
The comment, up to 2,000 characters.
Whether only the administrators of the instance read it. False when left out.
Whether to show it without your name. False when left out, and ignored on a private comment.
Returns
The new comment object. A change that does not exist answers 404.
The comment.
Always changelog_comment. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.
The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.
Everything the record holds.
The name of the person who wrote it, or Anonymous, in your language, when they chose not to show it. An anonymous comment shows Anonymous to everybody, its author included.
Whether you wrote it.
Whether only the administrators of the instance read it. Only its author sees a private comment in this list.
Whether it is shown without the name of its author. A private comment is never anonymous.
The comment, as plain text.
The public answers of the administrators, which is an empty list for a new comment.
When the comment was written, as a count of seconds since 1970.
When the comment last changed, as a count of seconds since 1970.
Rate limit
Ten requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.