card_limit
Change the daily spending limit on the user's Picnic (Gnosis Pay) card. Returns a sign_url and a resource_uri; execution starts as soon as the user signs.
The limit is enforced on-chain by the AllowanceModule on Gnosis. Picnic enqueues the new allowance via its delay module; the on-chain setAllowance dispatch lands ~3 minutes later via the delay-module cooldown. The action's status reaches executed once the enqueue is confirmed — surfacing the delayed dispatch as a separate state is on the roadmap.
Required scope: manage:card
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
formatted_amount | string | yes | New daily limit, decimal-formatted in the card's fiat currency (e.g. "200" or "199.99"). The currency itself comes from the user's card metadata — agents shouldn't try to override it. |
period | string | yes | Refill period. Only "daily" is currently supported; the tool rejects any other value. |
Returns:
| Field | Type | Description |
|---|---|---|
action_id | string | UUID for the pending action. |
status | string | Always "proposed" immediately after this tool returns. |
summary | string | Human-readable summary (e.g. "Set Picnic card daily limit to €200"). |
sign_url | string | URL the user opens to authorize with their passkey. |
resource_uri | string | picnic://action/{action_id}. Subscribe for notifications/resources/updated. |
expires_at | date | ISO timestamp; 10 minutes after creation. |
Action lifecycle: proposed → signed → submitted → executed (enqueue-confirmed; on-chain dispatch follows later).
Other terminal states: failed, expired, rejected.
Example prompts:
"Lower my Picnic card daily limit to €100."
"Bump my card limit to €500 a day."