Add a comment to an AI project

POST 
/ai/projects/:project_id/comments

Posts a comment on an AI project and returns the identifier of the new comment. You need at least read-only access on the project, so any project member can comment. You are recorded as the author, and the comment is timestamped server-side. Project stewards are notified by email and push notification; if notification fails the comment is still saved and the call still succeeds.

Request

Responses

200

The comment was saved. CommentId is the identifier of the new comment; pass it to the delete endpoint to remove it later.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

400

The request was invalid or you do not have permission. The body is {"Message": " - "}. Common cases include a missing role_id header (AUTH-1001), a role without the ai.view permission (AUTH-1030), no read-only access on the project (AUTH-1012), a missing Type or Description (IPV-1008), a Type outside the allowed values (IPV-1041), a Description that is empty or not a string (IPV-1045), and a Description longer than 1000 characters (IPV-1076). A body missing the required fields altogether is rejected by request validation before it reaches the service. Permission failures return 400, not 403.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

500

An unexpected server error, including a failure to store the comment. The body is {"Message": " - "}, normally GE-1008.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security