Request human approval
request_approvalRoute invoices that fail three-way matching to a person for approval; accept only received or on-hold invoices with exceptions and return the existing pending request instead of creating another.
Instructions
Sends an invoice that failed three-way matching to a person for approval. Only received or on-hold invoices with exceptions are accepted. Calling it again for the same invoice returns the pending request instead of creating a second one.
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": {
"invoiceId": "<invoiceId>",
"reason": "<reason>"
},
"name": "request_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Why a person should look at this invoice, in plain language, for the approver | |
| invoiceId | Yes | Internal invoice id, for example INV-1001 | |
| requestedBy | No | Who is asking, for the audit trail | ai-agent |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| created | Yes | ||
| approval | Yes |