update_card_limit

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 and retry). Cards funded from a company wallet are not resized here — their money is pool-accounted, so the company raises them server-side with POST /api/v1/cards/{id}/topups.

Cards from another app. On a personal card a different connected app minted (access: "connected" in 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.

Example

{ "name": "update_card_limit", "arguments": { "card_id": "card_abc123", "new_limit_cents": 20000 } }

⌘I

Getting Started

Authentication

Guides

Webhooks

Funding options

Withdrawals

MCP

Examples

Parameters

Returns

Example

​Parameters

​Returns

​Example

Parameters

Returns

Example