Comment on candidate
Post a comment on a candidate profile and tag teammates with @.
POST https://cotlet.dev/api/v1/comeet/candidates/{candidate_id}/comments
write Confirm
Posts one comment on the activity log. Type @ and a teammate's name in the body to tag them; every tagged teammate gets an email with the thread. visibility is one of position_access, hiring_leadership, position_recruiters or only_me, and the teammates you can tag are limited to those who may see the discussion. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate from list_candidates. |
| body string required | string | Comment text, with @ and a name to tag. |
| visibility enum | enum | position_access (default), hiring_leadership, position_recruiters or only_me. |
Request
curl -X POST https://cotlet.dev/api/v1/comeet/candidates/cand_5a11c8/comments \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"@Dana Cho this Go/No-go has waited 6 days. Can you decide today?","visibility":"position_recruiters"}'result = client.call("comeet", "add_comment", {"candidate_id":"cand_5a11c8","body":"@Dana Cho this Go/No-go has waited 6 days. Can you decide today?","visibility":"position_recruiters"})const result = await cotlet.call('comeet', 'add_comment', {"candidate_id":"cand_5a11c8","body":"@Dana Cho this Go/No-go has waited 6 days. Can you decide today?","visibility":"position_recruiters"});cotlet call comeet add_comment --data '{"candidate_id":"cand_5a11c8","body":"@Dana Cho this Go/No-go has waited 6 days. Can you decide today?","visibility":"position_recruiters"}'Example response
{
"comment_id": "cmt_90f2",
"candidate_id": "cand_5a11c8",
"visibility": "position_recruiters",
"mentioned": [
"Dana Cho"
],
"posted_at": "2026-10-22T08:05:00Z"
}