Post a comment on an incident
POST/v2/incidents/:id/comments
Attaches a free-text comment (max 10,000 chars). Dedup: identical text on the same
incident from the same integration returns the prior write's operation_id instead of
creating a duplicate. Vary the text (for example, append a timestamp) to post the same content twice.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
- 503
Comment created (or dedup match returned).
Validation failure. See error.code (VALIDATION_ERROR, INVALID_STATUS_TRANSITION, COMMENT_REQUIRED, USER_NOT_FOUND, INVALID_DISPLAY_ID, BULK_ACTION_FIELD_MISMATCH, BULK_LIMIT_EXCEEDED).
UNAUTHORIZED: missing or invalid bearer token, or wrong token type for a write route.
Access denied. Possible codes are ACCESS_DENIED, TWO_WAY_DISABLED, MODULE_ACCESS_DENIED, INCIDENT_ARCHIVED, org/user inactive, or integration configuration inactive.
Target entity (or job) not found in the token's org tree.
RATE_LIMIT_EXCEEDED: the per-token budget is exhausted. Back off per the Retry-After header.
Response Headers
Seconds to wait before retrying.
INTEGRATION_PLATFORM_UNAVAILABLE or INTEGRATION_AUTH_UNAVAILABLE: transient upstream failure, safe to retry.