Issues

Comment on an issue

Posts a comment, on an open or closed issue. A person may make it guidance, advice every later investigation on the issue's entities weighs.

post/v1/issues/{idOrNumber}/comments

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header GREPR-API-KEY
    • or OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Path parameters

idOrNumberstring required

Request body

bodystring required

The markdown body.

guidanceboolean

Makes it guidance, advice every later investigation on the issue's entities weighs; people only.

lockedFieldProposalstring

The locked field the comment proposes changing, named as in a FIELD_LOCKED error: a field such as priority, or label:<label>.

versioninteger

The version the comment was written against; a stale one is rejected with 409 and the current issue. Null posts against whatever is current.

Response

Comment posted

bodystring

The markdown body.

channel'REST' | 'MCP' | 'SYSTEM'

How a change reached the server.

createdAtstring date-time

When it was written.

editedAtstring date-time

When its author last changed the body, or null.

guidanceboolean

Whether it is guidance, which agents weigh as advice.

guidanceSetAtstring date-time

When it was marked guidance, or null.

guidanceSetBystring

The user id of the person who marked it guidance, or null.

idstring

The comment id.

issueIdstring

The issue it is on.

lockedFieldProposalstring

The locked field the comment proposes changing, as named in a FIELD_LOCKED error (priority, label:cost), or null.

Changes

No recorded changes to this operation across all 1 revision of this API.