increase-test
POST/digital_card_profiles/{digital_card_profile_id}/clone

Clone a Digital Card Profile

Clones a Digital Card Profile to create another profile with the supplied artwork and metadata. Provide any fields you want to set on the clone; all body fields are optional, and omitted values are not constrained by required-field rules.

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

1 parameter · 9 body fields
digital_card_profile_idstringrequired
The identifier of the Digital Card Profile to clone.

Optional fields to set on the cloned Digital Card Profile.

app_icon_file_idstringoptional
The identifier of the File containing the card's icon image.
background_image_file_idstringoptional
The identifier of the File containing the card's front image.
card_descriptionstringoptional
A user-facing description for the card itself.
contact_emailstringoptional
An email address the user can contact to receive support for their card.
contact_phonestringoptional
A phone number the user can contact to receive support for their card.
contact_websitestringoptional
A website the user can visit to view and receive support for their card.
descriptionstringoptional
A description you can use to identify the Card Profile.
issuer_namestringoptional
A user-facing description for whoever is issuing the card.
text_colorobjectoptional
The Card's text color, specified as an RGB triple. The default is white.

3 status codes
200Returns the cloned Digital Card Profile, including its new identifier, status, artwork file identifiers, contact details, and text color.
app_icon_file_idstringrequired
The identifier of the File containing the card's icon image.
background_image_file_idstringrequired
The identifier of the File containing the card's front image.
card_descriptionstringrequired
A user-facing description for the card itself.
contact_emailstringrequired
An email address the user can contact to receive support for their card.
contact_phonestringrequired
A phone number the user can contact to receive support for their card.
contact_websitestringrequired
A website the user can visit to view and receive support for their card.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Digital Card Profile was created.
descriptionstringrequired
A description you can use to identify the Card Profile.
idstringrequired
The Card Profile 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).
issuer_namestringrequired
A user-facing description for whoever is issuing the card.
statusstringrequired
The status of the Card Profile.
Allowed:pendingrejectedactivearchived
text_colorobjectrequired
The Card's text color, specified as an RGB triple.
typestringrequired
A constant representing the object's type. For this resource it will always be `digital_card_profile`.
Allowed:digital_card_profile
4XXReturned when the request results in a client error.
5XXReturned when the server encounters an error processing the request.

Error handling

The digital_card_profile_id path parameter must identify an existing Digital Card Profile. If provided, description must be 1–200 characters; issuer_name and card_description must be 1–32 characters, and contact_email must be a valid email address of 1–32 characters.