Create a comment

POST 
/api/v1/evals/create-comment

Attaches a reviewer note to an evaluation object. Author attribution comes from trusted caller context when available; a bare key may create an unattributed comment. Current withdrawal suppresses platform reads rather than proving physical erasure.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Review and score turns

Request

Responses

200

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

Section ID: DOC-IS-evaluation-api-createComment#example-evals-createComment-request

Request example

{
  "objectType": "COMMENT_OBJECT_TYPE_TRACE",
  "objectId": "example_123",
  "content": "Example text"
}

Guide request for Save the explanation with the reviewed turn. Replace example resource identifiers with your own authorized values.

Section ID: DOC-IS-evaluation-api-createComment#example-cookbook-insights-evaluation-review-06-request

Request example

{
  "objectType": "COMMENT_OBJECT_TYPE_TRACE",
  "objectId": "trc_a1b2c3",
  "content": "Tool call returned stale data."
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-IS-evaluation-api-createComment#example-evals-createComment-response

Response example

{
  "commentId": "example_123"
}

Document ID: DOC-IS-evaluation-api-createComment. Section identities and revisions.

Section	Stable reference
Create a comment	DOC-IS-evaluation-api-createComment#overview
Request	DOC-IS-evaluation-api-createComment#request
Responses	DOC-IS-evaluation-api-createComment#responses