Write off time
write_off_timeWrite off hours from an approved time report, removing them from the billable pool without invoicing (e.g. discounts or goodwill). Requires Finance role or above.
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": {
"time_report_id": "<time_report_id>",
"hours": "<hours>",
"reason": "<reason>"
},
"name": "write_off_time"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | Yes | Number of hours to write off (required, must be > 0 and ≤ remaining billable hours). | |
| reason | Yes | Reason for the write-off (required). | |
| confirm | No | Set true to perform the action. Omit or false returns a preview only — nothing is written. | |
| time_report_id | Yes | ID of the approved time report to write off hours from (required). | |
| idempotency_key | No | Optional caller-supplied key; retrying with the same key returns the original result instead of acting twice. |