add_ticket_comment
Add a comment to a ticket and return the updated ticket. This write operation is disabled by default and requires the crm:write scope.
Instructions
Add a comment to a ticket and return it updated.
Disabled by default (see config/scopes.yaml) -- this is the one
write-capable tool in the starter, gated behind the crm:write
scope to demonstrate least-privilege-by-default.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticket_id": "<ticket_id>",
"author": "<author>",
"body": "<body>"
},
"name": "add_ticket_comment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| author | Yes | ||
| ticket_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| status | Yes | ||
| subject | Yes | ||
| assignee | No | ||
| comments | No | ||
| priority | Yes | ||
| created_at | Yes | ||
| updated_at | Yes | ||
| description | Yes | ||
| requester_email | Yes |