Skip to main content
PUT
/
cards
/
{id}
Update Card
curl --request PUT \
  --url https://api.sandbox.sudo.cards/cards/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "active",
  "fundingSourceId": "<string>",
  "metadata": "<string>",
  "spendingControls": {
    "allowedCategories": [],
    "blockedCategories": [],
    "channels": {
      "atm": true,
      "pos": true,
      "web": true,
      "mobile": true
    },
    "spendingLimits": [
      {
        "amount": 123,
        "interval": "daily"
      }
    ]
  },
  "cancellationReason": "lost",
  "creditAccountId": "<string>"
}
'
"{}"

Authorizations

​
Authorization
string
header
default:{{APIKey}}
required

Path Parameters

​
id
string
required

The _id of the card to update.

Body

application/json
​
status
enum<string>
default:active
required

The card status.

Available options:
active,
inactive,
canceled
​
fundingSourceId
string

The funding source _id. Required if you wish to map card to an existing funding source.

​
metadata
string<json>

The metadata object to attach to the card. Stored in key-value pair

​
spendingControls
object

Card spending controls. Default usage limits will be applied if non is provided.

​
cancellationReason
enum<string>

Required if status is set to canceled

Available options:
lost,
stolen
​
creditAccountId
string

The credit account _id. Required for canceled status only.

Response

200

The response is of type object.