Update a Card

Learn how to update the general data of a digital business card.

All BODY parameters can be passed, or only certain ones, but at least one parameter must be included. position, department, and short_description are fields that support multilingualism.

If you want to support multilingual fields, pass these parameters as an array in the following JSON format:

// If you want to support Multilanguage JSON-ARRAY
{
    "en": "Chief Marketing Officer",
    "es": " Director de marketing"
}

POST /v1/cards/{CARD_UUID}

Request Body

Name	Type	Description
access_pin	string	min:4|max:4 character
username	string	min:3|max:100 character
firstName	string
lastName	string
position	string/array	SEE DESCRIPTION
department	string/array	SEE DESCRIPTION
short_description	string/array	SEE DESCRIPTION
prefix	string
suffix	string
organisation	string
color	string	HEX Code with # (Hashtag)
public	boolean
focus	enum	contact or socialmedia

200: OK

{
    "data": {
        "uuid": "z5C1YDXXXXX",
        "public": true,
        "username": "jon-doe-7793",
        "firstName": "Jon",
        "lastName": "Doe",
        "prefix": null,
        "suffix": null,
        "display_name": "Jon Doe",
        "organisation": "Democompany",
        "position": "CTO",
        "department": null,
        "focus": "contact",
        "template": "recent",
        "color": null,
        "visible": 0,
        "is_premium": false,
        "is_business": false,
        "space": null,
        "redirection": null,
        "video_frame": null,
        "short_description": null,
        "assets": {
            "avatar": {
                "uuid": null,
                "src": "https://cdn.becard.me/default/card_v1.jpg"
            },
            "header": null,
            "logo": null
        },
        "contacts": [
            {
                "uuid": "zUiuYQvXXXXX",
                "type": "phone",
                "category": "default",
                "pos": null,
                "name": null,
                "value": "165655650",
                "prefix": "+43",
                "default": 1
            }
        ],
        "addresses": null,
        "social_media": [],
        "settings": {
            "protection": {
                "enable_pin": false
            },
            "layout": {
                "save_avatar": true,
                "show_avatar": true,
                "show_logo": true,
                "show_icon": false,
                "show_header": true,
                "show_organisation": true,
                "show_address": true,
                "show_vcf_link": true,
                "show_login_button": true,
                "show_becard_logo": true,
                "enable_backgrounds": false,
                "enable_blur": false,
                "enable_dark_mode": false,
                "enable_favicons": false
            },
            "services": {
                "enable_contact_book": false,
                "enable_multi_language": false,
                "enable_social_media": true,
                "enable_wallets": true,
                "enable_pushNotifications": false,
                "enable_pushNotifications_fields": {
                    "pushNotification_id": "HtLWN3tXXXX"
                },
                "enable_newsletter": false,
                "enable_newsletter_fields": {
                    "email": true,
                    "name": true,
                    "phone": false
                },
                "enable_qrCode": true,
                "enable_affiliate": false,
                "enable_affiliate_fields": {
                    "code": null,
                    "link": null
                }
            }
        },
        "connected_cards": 0,
        "access_pin": null,
        "created_at": "2024-02-06T17:49:34.000000Z",
        "updated_at": "2024-02-07T08:35:50.000000Z"
    }
}