Void invoice
void_invoiceVoid an issued invoice (reason required): releases source hours back to Approved and retains the immutable void record. IRREVERSIBLE. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit.
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": {
"invoice_id": "<invoice_id>",
"reason": "<reason>"
},
"name": "void_invoice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Required reason for voiding (recorded in the audit trail). | |
| invoice_id | Yes | Id of the issued invoice to void. | |
| confirm_token | No | Token returned by the preview (call this tool once with no token to get it). Required to commit; expires in ~10 minutes. | |
| idempotency_key | No | Required when committing (confirm_token present): retrying with the same key returns the original result instead of acting twice. |