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

2026-07-17T08:40:10Z

‎Successful Response (200)

Ashley DeBon: Created page with "== Update Contact Personnel == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contacts/{id}/contact-personnel/{personnel_id} === Purpose === Updates..."

2026-07-17T08:39:37Z

Created page with "== Update Contact Personnel == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contacts/{id}/contact-personnel/{personnel_id} === Purpose === Updates..."

New page

== Update Contact Personnel ==

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

=== Endpoint ===
/api/contacts/{id}/contact-personnel/{personnel_id}

=== Purpose ===
Updates an existing person associated with a specific contact. The request can change name, email, title, role, notes, phone numbers, and optionally the person’s image so the contact’s personnel record stays current.

=== HTTP Method ===
PUT

=== Headers ===
{| class="wikitable"
! Header !! Required !! Description
|-
| Authorization || Yes || Bearer access token
|}

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

=== Parameters ===

==== Path Parameters ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| id || integer || Yes || Unique identifier of the contact that owns the personnel record
|-
| personnel_id || integer || Yes || Unique identifier of the person to update
|}

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

==== Request Body ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| first_name || string || Yes || First name of the person (maximum 73 characters)
|-
| last_name || string || No || Last name of the person (maximum 30 characters)
|-
| email || string || No || Email address (maximum 64 characters). Must be a valid email format when provided
|-
| title || string || No || Job title (maximum 73 characters)
|-
| people_role_id || integer || No || People role identifier for the person
|-
| phones || string || No || JSON array of phone objects. Each object may include <code>id</code> (existing phone ID, or 0 for new), <code>phone_number</code> (maximum 15 characters), <code>phone_type_id</code>, <code>country_code</code>, and <code>extension</code> (maximum 6 characters)
|-
| contact_notes || string || No || Notes associated with the person
|-
| contact_image || file || No || Updated profile image file for the person
|-
| form_data || string || No || JSON custom field data; used when an image-type custom field should store the uploaded image reference
|}

=== Successful Response (200) ===
Indicates that the contact person 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, "Contact Personnel Updated Successfully")
|-
| uri || string || Requested resource URI
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 200 || Validation failure – request body failed validation (returned with an error payload and <code>clientStatusCode</code> 401)
|-
| 400 || Bad Request – the contact person could not be updated
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''200 (validation failure)''' – Fields failed Form Request validation (for example, invalid email or invalid phones JSON / phone number or extension length).
* '''400''' – First name is missing; a field exceeds its maximum length; the contact or personnel record was not found; a phone number conflict occurred ("Phone Number Already Exists"); or another error occurred while updating the person.
* '''401''' – Authentication failed or the access token is missing/expired.

@@ Line 59: / Line 59: @@
 | form_data || string || No || JSON custom field data; used when an image-type custom field should store the uploaded image reference
 |}
 === Successful Response (200) ===

Update the Contact Personnel Details - Revision history

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

Ashley DeBon: Created page with "== Update Contact Personnel == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contacts/{id}/contact-personnel/{personnel_id} === Purpose === Updates..."