> ## 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.

# update_card_limit

> Raise or lower the total spend limit of a multi-use card

Changes the total spend limit of a multi-use card. Raising the limit reserves the difference from the cash balance up front; lowering it releases the difference back to the balance. Works on open and paused cards.

## Parameters

| Parameter         | Type   | Required | Description                                                                                                                                                                      |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `card_id`         | string | Yes      | The multi-use card to update                                                                                                                                                     |
| `new_limit_cents` | number | Yes      | The new total limit in cents. Must be at least what the card has already spent, and within the per-card cap in effect (company connections have none).                           |
| `approval_id`     | string | No       | Approval id from a prior `approval_required` response on a card another app created, once the user has approved. The approval binds to the exact new limit it was requested for. |

## Returns

The card's new spend limit and remaining balance. Two guards to know about: the new limit can never be set below what the card has already spent, and raising the limit fails with `insufficient_collateral` when the balance cannot cover the increase (add funds with [add\_funds](/companies/mcp/tools/add_funds) and retry). Cards funded from a [company wallet](/companies/wallet-funding/company-wallet) cannot be resized; close the card and issue a new one instead.

<Note>
  **Cards from another app.** On a personal card a different connected app minted (`access: "connected"` in [list\_cards](/companies/mcp/tools/list_cards)), this call returns `approval_required` with an `approvalId` instead of updating. The user is emailed an approve/deny link naming the new limit; once they approve, retry with `approval_id` and the **same** `new_limit_cents`. See [One wallet across apps](/companies/mcp/overview#one-wallet-across-apps).
</Note>

## Example

```json theme={null}
{ "name": "update_card_limit", "arguments": { "card_id": "card_abc123", "new_limit_cents": 20000 } }
```