latestOpenAPI 3.0.02026-08-12207455917.9 KB

bad0d2db9b7a

Contacts

Update contact

Partially update a directory contact. Only the contact creator can update it. Non-brokers cannot update shared contacts.

Validation & Requirements

Required Parameters

  • contactGuid (path, string, format=guid)

Required JSON Body Fields

  • None

Validations

  • Invalid GUID values in *Guid/*Guids fields return 422 Unprocessable Entity.
  • Invalid date values in *date* fields return 422 Unprocessable Entity.
  • Missing required request body returns 422 Unprocessable Entity with Missing request body..
  • Additional business-rule validation may return 422 with details in the errors array.
  • Phone, fax, and alternate phone values must be exactly 10 numeric digits (no separators).
  • If email is provided, it must be a valid email format.
  • City cannot contain numeric digits.
patch/api/contacts/{contactGuid}

Path parameters

contactGuidstring guid required

GUID of the contact to update.

Query parameters

FirstNamestring nullable
LastNamestring nullable
Companystring nullable
Emailstring nullable
StreetNumberstring nullable
StreetNamestring nullable
Zipstring nullable
Citystring nullable
Statestring nullable
Phonestring nullable
AlternatePhonestring nullable
Faxstring nullable
IsSharedboolean nullable
IsCompanyboolean nullable

Response

warningsstring[] nullable