Ashley DeBon: /* Successful Response (200) */

2026-07-17T13:59:26Z

‎Successful Response (200)

Ashley DeBon: Created page with "== Update Business Card == === Base URL === https://apimobile.callproof.com === Endpoint === /api/edit-business-cards/{id} === Purpose === Updates an existing business card..."

2026-07-17T13:54:50Z

Created page with "== Update Business Card == === Base URL === https://apimobile.callproof.com === Endpoint === /api/edit-business-cards/{id} === Purpose === Updates an existing business card..."

New page

== Update Business Card ==

=== Base URL ===
https://apimobile.callproof.com

=== Endpoint ===
/api/edit-business-cards/{id}

=== Purpose ===
Updates an existing business card’s details for the authenticated user. Optionally replaces the front image. If a new email is provided, it must not already belong to another of the user’s business cards.

=== HTTP Method ===
POST

=== Headers ===
{| class="wikitable"
! Header !! Required !! Description
|-
| Authorization || Yes || Bearer access token
|-
| Content-Type || Conditional || Use <code>multipart/form-data</code> when uploading a new image
|}

=== Security ===
* '''Yes''' – Requires Bearer Token authentication.

=== Parameters ===

==== Path Parameters ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| id || integer || Yes || Unique identifier of the business card to update
|}

==== Query Parameters ====
None.

==== Request Body ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| first_name || string || No || Updated first name
|-
| last_name || string || No || Updated last name
|-
| title || string || No || Updated job title
|-
| company_name || string || No || Updated company name
|-
| address || string || No || Updated address (maximum 255 characters)
|-
| website || string || No || Updated website
|-
| email || string || No || Updated email (must be a valid email format; must not already exist on another card for the same user, unless it is unchanged)
|-
| phone_number || string || No || Updated phone number (digits only; 7–15 characters when provided)
|-
| notes || string || No || Updated notes
|-
| business_card_image || file || No || New front image for the business card
|}

=== Successful Response (200) ===
Indicates that the business card was updated successfully.

{| class="wikitable"
! Field !! Type !! Description
|-
| clientStatusCode || integer || Status indicator for the client (for example, 200)
|-
| user_id || integer || Identifier of the authenticated user
|-
| company_id || integer || Identifier of the authenticated user’s company
|-
| message || string || Confirmation message (for example, "The Business card details updated successfully.")
|-
| uri || string || Requested resource URI
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 200 || Validation failed – response body uses <code>clientStatusCode</code> 401 with the first validation error message
|-
| 400 || Bad Request – the business card could not be updated
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''Validation (HTTP 200, clientStatusCode 401)''' – Invalid email, invalid phone number, or address longer than 255 characters.
* '''400''' – Email already exists ("Email already exists"), or another update error (for example, "Error while updating the business card details").
* '''401''' – Authentication failed or the access token is missing/expired.

@@ Line 61: / Line 61: @@
 | business_card_image || file || No || New front image for the business card
 |}
 === Successful Response (200) ===

Update Business Card details - Revision history

Ashley DeBon: /* Successful Response (200) */

Ashley DeBon: Created page with "== Update Business Card == === Base URL === https://apimobile.callproof.com === Endpoint === /api/edit-business-cards/{id} === Purpose === Updates an existing business card..."