---
title: "Changes to Update a card"
method: PATCH
path: "/cards/{id}"
---

# Changes to Update a card

`PATCH /cards/{id}`

> Every recorded change to this operation, newest first.
> 115 revisions in range; 2 not diffed.

## Timeline

Changed in 15 of 115 revisions.

- **2026-10-28** `d996ddfb9d2b`: 2 info
- **2026-10-27** `5fbda612feb8`: 6 breaking, 3 warning, 1 info
- **2026-10-26** `f11f1e76bdd7`: 1 warning
- **2026-10-26** `0a6dad5815c7`: 1 warning
- **2026-10-24** `715332dcb111`: 1 warning
- **2026-10-22** `5547c7aba40e`: 2 info
- **2026-10-20** `761d1d030cb5`: 2 warning
- **2026-10-18** `6d80d648535e`: 7 info
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
- **2026-10-09** `36ec020f29da`: 1 warning, 1 info
- **2026-10-09** `f11cc4a8f2f4`: 2 warning
- **2026-10-05** `6d67fe99049c`: 3 info
- **2026-10-05** `32bcbd4023e4`: 3 warning
- **2026-10-02** `dfe5a02f2fee`: 16 breaking, 68 warning, 31 info
- **2026-05-28** `d0bce562bffd`: 1 info

## Changes

- **2026-10-28** `d996ddfb9d2b`: 2 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `400` status
- **2026-10-27** `5fbda612feb8`: 6 breaking, 3 warning, 1 info
  - removed the required property `cardCapabilities/supportsSpendLimits` from the response with the `200` status
  - removed the required property `cardCapabilities/supportsSpendLimitsAtIssuance` from the response with the `200` status
  - removed the required property `cardCapabilities/supportsTransactionCountLimit` from the response with the `200` status
  - removed the required property `maxSpendPerDay` from the response with the `200` status
  - removed the required property `maxSpendPerTransaction` from the response with the `200` status
  - removed the required property `maxTransactionsPerDay` from the response with the `200` status
  - removed the request property `maxSpendPerDay`
  - removed the request property `maxSpendPerTransaction`
  - removed the request property `maxTransactionsPerDay`
  - added the required property `cardCapabilities/supportsVelocityLimits` to the response with the `200` status
- **2026-10-26** `f11f1e76bdd7`: 1 warning
  - added the new `PURCHASE_CARD_LIMIT_REACHED` enum value to the `code` response property for the response status `409`
- **2026-10-26** `0a6dad5815c7`: 1 warning
  - added the new `INVOICE_ALREADY_USED` enum value to the `code` response property for the response status `409`
- **2026-10-24** `715332dcb111`: 1 warning
  - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400`
- **2026-10-22** `5547c7aba40e`: 2 info
  - added the new optional request property `maxNetworkRiskScore`
  - added the optional property `maxNetworkRiskScore` to the response with the `200` status
- **2026-10-20** `761d1d030cb5`: 2 warning
  - added the new `AGENT_CARD_EXISTS` enum value to the `code` response property for the response status `409`
  - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-18** `6d80d648535e`: 7 info
  - added the new optional request property `allowedMccs`
  - added the new optional request property `blockedMccs`
  - added the new optional request property `defaultMccBlocksLifted`
  - added the optional property `agentId` to the response with the `200` status
  - added the optional property `allowedMccs` to the response with the `200` status
  - added the optional property `blockedMccs` to the response with the `200` status
  - added the optional property `defaultMccBlocksLifted` to the response with the `200` status
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
  - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-09** `36ec020f29da`: 1 warning, 1 info
  - added the new `PIN_CHANGE_REQUIRED` enum value to the `code` response property for the response status `409`
  - added the optional property `pinUnblockAvailableAt` to the response with the `200` status
- **2026-10-09** `f11cc4a8f2f4`: 2 warning
  - added the new `DELEGATION_REQUIRED` enum value to the `statusReason` response property for the response status `200`
  - added the new `PENDING_AUTH` enum value to the `status` response property for the response status `200`
- **2026-10-05** `6d67fe99049c`: 3 info
  - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400`
  - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
  - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
- **2026-10-05** `32bcbd4023e4`: 3 warning
  - added the new `AUTH_CREDENTIAL_VERIFICATION_EXPIRED` enum value to the `code` response property for the response status `400`
  - added the new `AUTH_CREDENTIAL_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `OPERATION_IN_PROGRESS` enum value to the `code` response property for the response status `409`
- **2026-10-02** `dfe5a02f2fee`: 16 breaking, 68 warning, 31 info
  - removed the required property `cardholderId` from the response with the `200` status
  - removed the required property `fundingSources` from the response with the `200` status
  - removed the required property `message` from the response with the `400` status
  - removed the required property `message` from the response with the `401` status
  - removed the required property `message` from the response with the `404` status
  - removed the required property `message` from the response with the `409` status
  - removed the required property `message` from the response with the `500` status
  - removed the required property `message` from the response with the `501` status
  - removed the required property `state` from the response with the `200` status
  - removed the required property `status` from the response with the `400` status
  - removed the required property `status` from the response with the `401` status
  - removed the required property `status` from the response with the `404` status
  - removed the required property `status` from the response with the `409` status
  - removed the required property `status` from the response with the `500` status
  - removed the required property `status` from the response with the `501` status
  - removed the success response with the status `202`
  - deleted the `header` request parameter `Grid-Wallet-Signature`
  - deleted the `header` request parameter `Request-Id`
  - removed the request property `fundingSources`
  - removed the request property `state`
  - removed the optional property `panEmbedUrl` from the response with the `200` status
  - removed the optional property `stateReason` from the response with the `200` status
  - added the new `ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `AUTH_METHOD_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `BANK_ACCOUNT_VALIDATION_PENDING` enum value to the `code` response property for the response status `409`
  - added the new `BENEFICIARY_TRUSTED` enum value to the `code` response property for the response status `409`
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
  - added the new `CARD_ALREADY_CLOSED` enum value to the `code` response property for the response status `409`
  - added the new `CARD_LIMIT_REACHED` enum value to the `code` response property for the response status `409`
  - added the new `CARD_NOT_MUTABLE` enum value to the `code` response property for the response status `409`
  - added the new `CUSTOMER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `DOCUMENTS_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `DOCUMENT_ALREADY_EXISTS` enum value to the `code` response property for the response status `409`
  - added the new `DOCUMENT_HOLDER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `DUPLICATE_EXTERNAL_ACCOUNT` enum value to the `code` response property for the response status `409`
  - added the new `DUPLICATE_PAY_REQUEST` enum value to the `code` response property for the response status `409`
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `INSUFFICIENT_FUNDS` enum value to the `code` response property for the response status `400`
  - added the new `INVALID_STATE_TRANSITION` enum value to the `code` response property for the response status `409`
  - …75 more
- **2026-05-28** `d0bce562bffd`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/cards/:id/patch.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/cards/:id/patch)
