---
title: "Update card"
method: PUT
path: "/v2/cards/{id}"
tags: ["Cards"]
---

# Update card

`PUT /v2/cards/{id}`

Update an existing vendor card

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- UpdateCardRequest
  - `spend_controls` SpendControlUpdateRequest
    - `spend_limit` Money — Money fields can be signed or unsigned. Fields are signed (an unsigned value will be interpreted as positive). The amount of money will be represented in the smallest denomination of the currency indicated. For example, USD 7.00 will be represented in cents with an amount of 700.
      - `amount` integer, required — The amount of money, in the smallest denomination of the currency indicated by currency. For example, when currency is USD, amount is in cents.
      - `currency` string, nullable — The type of currency, in ISO 4217 format.
    - `spend_duration` 'MONTHLY' | 'QUARTERLY' | 'YEARLY' | 'ONE_TIME' — Spend limit refresh frequency - MONTHLY: The spend limit refreshes every month - QUARTERLY: The spend limit refreshes every quarter - YEARLY: The spend limit refreshes every year - ONE_TIME: The limit does not refresh
    - `reason` string, nullable
    - `lock_after_date` string, date, nullable
    - `allowed_merchant_details` LockedMerchantDetails[], nullable — List of merchants where card transactions are allowed. Cannot be used together with blocked_merchant_details. Maximum 50 merchant details.
      - `name` string, required — The name of the merchant.
    - `blocked_merchant_details` LockedMerchantDetails[], nullable — List of merchants where card transactions are blocked. Cannot be used together with allowed_merchant_details. Maximum 50 merchant details.
      - `name` string, required — The name of the merchant.
  - `metadata` object, nullable — Set of key value pairs associated with this object. Please do not store any personally identifiable or sensitive information here. Limitations: maximum of 50 keys, keys cannot exceed 40 characters, values cannot exceed 500 characters.

## Response `200`

updateCard 200 response

- Card — unresolved $ref

---

[API](https://skmtc.net/brex-com/apis/team-api.md) · [All operations](https://skmtc.net/brex-com/apis/team-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/team-api/revisions/58e231ca118e/schema)