Add a comment
Add a comment to a job, location, quote or deficiency.
POST https://cotlet.dev/api/v1/servicetrade/entities/{entity_id}/comments
write Confirm
Returns the comment id. A private comment is seen by your own staff; a customer comment can also be seen by the customer. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| entity string required | string | One of job, location, quote, deficiency. |
| entity_id integer required | integer | Id of the job, location, quote or deficiency. |
| content string required | string | Text of the comment. |
| visibility string | string | One of private, customer. private is visible only to users of your account. |
Request
curl -X POST https://cotlet.dev/api/v1/servicetrade/entities/1/comments \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"entity":"entity","content":"content"}'result = client.call("servicetrade", "add_comment", {"entity":"entity","entity_id":1,"content":"content"})const result = await cotlet.call('servicetrade', 'add_comment', {"entity":"entity","entity_id":1,"content":"content"});cotlet call servicetrade add_comment --data '{"entity":"entity","entity_id":1,"content":"content"}'Example response
{
"comment_id": 604411,
"entity": "job",
"entity_id": 48213,
"visibility": "private",
"created_at": "2026-10-26T09:12:00-04:00"
}