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

> Change a multi-use card's total spending limit.

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

**Behavior:** idempotent.

## What it does

Change a multi-use card's total spending limit. Raising it reserves the extra amount from the user's cash balance (top up with add\_funds if short); lowering it frees the difference, but the new limit can never go below what the card has already spent. Single-use cards cannot be resized.

## Inputs

| Field                  | Type   | Description                                                                                                                                                                                                    |
| ---------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `card_id` *(required)* | string | The multi-use card ID to resize.                                                                                                                                                                               |
| `approval_id`          | string | Approval id from a prior approval\_required response, once the user has approved. Only for cards created through ANOTHER app: first call without it (the user is emailed an approve link), then retry with it. |
| `spend_limit_cents`    | number | The new TOTAL spending limit in cents (minimum 100). This is the lifetime cap, not a delta: a card that spent \$20 of a \$50 limit, resized to 8000, can spend \$60 more.                                      |
| `new_limit_cents`      | number | Deprecated alias for spend\_limit\_cents. Prefer spend\_limit\_cents (matches the docs and the REST API).                                                                                                      |

## Returns

| Field                  | Type   | Description                                                                                                      |
| ---------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable result.                                                                                           |
| `status`               | string | "updated" on success; an error discriminator otherwise (e.g. "limit\_below\_spent", "insufficient\_collateral"). |
| `cardId`               | string | The card ID.                                                                                                     |
| `spendLimitCents`      | number | The new total limit in cents.                                                                                    |
| `balanceCents`         | number | The remaining spendable balance in cents.                                                                        |

## Example call

```json theme={null}
{
  "tool": "update_card_limit",
  "arguments": {
    "card_id": "\u2026"
  }
}
```