> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# approve_request

> Resolve a pending approval request (approve or deny) once the USER has decided.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

## What it does

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.

## Inputs

| Field | Type | Description |
| - | - | - |
| `approval_id` *(required)* | string | The approval request ID |
| `decision` *(required)* | string: `approved` · `denied` | Whether to approve or deny the request |
| `action` *(required)* | string: `card_details` · `transaction` · `cross_app:details` · `cross_app:close` · `cross_app:pause` · `cross_app:resume` · `cross_app:update` | The original action type from the approval prompt (list\_pending\_approvals rows carry it as action). |
| `resource_id` *(required)* | string | Card ID (for card\_details and cross\_app actions) or approval ID (for transaction) |

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable summary of the approval outcome and any follow-up action. |
| `status` | string | 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'. |
| `decision` | string | The decision that was applied: 'approved' or 'denied'. |
| `action` | string | The original action type from the approval prompt: 'card\_details' or 'transaction'. |
| `card` | object | The card resource returned by the approved follow-up action, when applicable. |

## Example call

```json theme={null}
{
  "tool": "approve_request",
  "arguments": {
    "approval_id": "\u2026",
    "decision": "\u2026",
    "action": "\u2026",
    "resource_id": "\u2026"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.