API DescriptionSettingsFAQ
API Reference

Update a card

post
https://api.mercury.com/api/v1/cards/

Update a card's nickname or spending limits.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Update a card. Adjust the nickname or spending controls. Status changes are handled through the dedicated freeze, unfreeze, and cancel endpoints — not the update endpoint.

Path Params
uuid
required

Unique identifier for a card

Body Params

At least one updateable field must be provided;
requests where every field is the same are rejected.

string | null
required

Updated card nickname. Omit to keep current, send null/empty to clear, send a string to set.

spendLimit
object | null

Updated spending controls for the card. Omit to leave unchanged.

Responses

400

Invalid body

404

cardId not found

Updated 21 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 21 days ago