approve_request
Resolve a pending approval request (approve or deny) once the USER has decided. Use this after get_card_details or create_card returns a 202 requiring approval, or for a row from list_pending_approvals. For card_details and transaction, approval automatically completes the follow-up action and returns the result. For cross_app actions (asks from another app: close/pause/resume a card, change a limit, view details), approval records the user's consent and the REQUESTING app completes the action from its side when it retries with the approval id.
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": {
"approval_id": "<approval_id>",
"decision": "<decision>",
"action": "<action>",
"resource_id": "<resource_id>"
},
"name": "approve_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The original action type from the approval prompt (list_pending_approvals rows carry it as action). | |
| decision | Yes | Whether to approve or deny the request | |
| approval_id | Yes | The approval request ID | |
| resource_id | Yes | Card ID (for card_details and cross_app actions) or approval ID (for transaction) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card | No | The card resource returned by the approved follow-up action, when applicable. | |
| action | No | The original action type from the approval prompt: 'card_details' or 'transaction'. | |
| status | No | Outcome of the request: 'denied', 'card_details', 'card_created', 'resolved' (cross_app approvals: consent recorded, the requesting app completes the action), 'personal_surface_only' (company-connected session; the user resolves personally), or 'unknown_action'. | |
| message | Yes | Human-readable summary of the approval outcome and any follow-up action. | |
| decision | No | The decision that was applied: 'approved' or 'denied'. |