v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Card Arts

Set Default Card Art

<a href="/card-issuance/v1.6/guide/card-products" style={{display:'inline-block',padding:'2px 10px',borderRadius:'9999px',fontSize:'12px',fontWeight:600,lineHeight:'18px',background:'#EEF2FF',color:'#4338CA',border:'1px solid #C7D2FE',textDecoration:'none'}}>Personal Visa only</a>

Sets the default card art for the issuing account. Subsequent Create Card requests that omit card_art_id will use this card art.

Passing the channel's system-default card art clears any explicit default; the account then falls back to the system default. See Card art for the full resolution order.

post/v1/issuing/cards/arts/default

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

Request body

card_art_idstring required

The card art to set as the issuing account's new default. Must be a card art available to the account (returned by List card arts).

Example request

{
  "card_art_id": "01KD52BKQWDMFF63R1NNQN7A79"
}

Response

Default card art updated successfully.

default_card_art_idstring required

The new default card art for the issuing account.

updated_atstring required

Server time at which the default was updated.

Example response

{
  "default_card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
  "updated_at": "2026-05-20 10:32:18"
}