Update a card specification

Requested cards accept a replacement specification. Pending issuance requests may update provider-supported fields on their existing request, subject to atomic provider approval checks; omitted optional fields remain unchanged and explicit empty lists clear them. Wallet/provider binding and unsupported fields cannot change after authorization starts. An uncertain update enters recovery_required and must not be retried. Checkout cards may be edited between authorizations.

PATCH /vaults/{id_or_name}/items/{key}

cURL

agentcard

curl --request PATCH \
  --url https://api.onkernel.com/vaults/{id_or_name}/items/{key} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "spec": {
    "amount": 3000,
    "card_id": "vc_example",
    "currency": "usd",
    "merchant": "Example Store",
    "provider": "agentcard",
    "wallet": "agentcard-wallet"
  }
}
'

200

agentcard

{
  "available_expansions": [],
  "available_operations": [],
  "created_at": "2026-01-01T12:00:00Z",
  "id": "card_agentcard_example",
  "key": "agentcard-card",
  "spec": {
    "amount": 3000,
    "card_id": "vc_example",
    "currency": "usd",
    "merchant": "Example Store",
    "provider": "agentcard",
    "wallet": "agentcard-wallet"
  },
  "state": {
    "aliases": {
      "cvc": "123",
      "exp_month": "12",
      "exp_year": "2030",
      "number": "4242424242424242"
    },
    "provider": "agentcard",
    "status": "ready"
  },
  "type": "card",
  "updated_at": "2026-01-02T12:00:00Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id_or_name · string · required

key · string · required

Required string length: 1 - 255

Body

application/json

spec · object · required

Live payment card. Test-mode card creation is not supported.

Option 1

Option 2

Show child attributes

Response

200

application/json

Vault item updated

Option 1

Option 2

available_expansions · object[] · required

Show child attributes

available_operations · object[] · required

Show child attributes

created_at · string<date-time> · required

id · string · required

key · string · required

Immutable item key assigned when the item is created.

spec · object · required

Option 1

Option 2

Show child attributes

state · object · required

Option 1

Option 2

Show child attributes

type · enum<string> · required

Available options: wallet

updated_at · string<date-time> · required

action · object

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Show child attributes

expanded · object

Live, non-persisted data requested through the item GET expand parameter.

Show child attributes

expires_at · string<date-time>