increase-test
PATCH/physical_cards/{physical_card_id}

Update a physical card

Updates the status of a physical card. Supply the new status, which must be active, disabled, or canceled.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
physical_card_idstringrequired
The identifier of the physical card to update.

The physical card status to set.

statusstringrequired
The status to update the Physical Card to.
Allowed:activedisabledcanceled

3 status codes
200Returns the updated physical card, including its current status and shipment information.
account_idstringrequired
The identifier for the Account this Physical Card belongs to.
card_idstringrequired
The identifier for the Card this Physical Card represents.
cardholderobjectrequired
Details about the cardholder, as it appears on the printed card.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Physical Card was created.
idstringrequired
The physical card identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
physical_card_profile_idstringrequired
The Physical Card Profile used for this Physical Card.
shipmentobjectrequired
The details used to ship this physical card.
statusstringrequired
The status of the Physical Card.
Allowed:activedisabledcanceled
typestringrequired
A constant representing the object's type. For this resource it will always be `physical_card`.
Allowed:physical_card
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the service encounters an internal error.

Error handling

The physical_card_id path parameter must identify the physical card to update. status is required and must be active, disabled, or canceled.