# Replace contact detail

Fully replaces an existing Contact Detail. All fields must be provided.

Endpoint: PUT /site/{siteId}/ahds/v1/contact-detail/{contactDetailId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `contactDetailId` (string, required)
    Contact Detail unique identifier (UUID)

## Request fields (application/json):

  - `contactDetailType` (object, required)
    Coded type of the contact detail (e.g. phone, email).

  - `contactDetailType.code` (string, required)
    Code value

  - `contactDetailType.system` (string, required)
    Code system URI

  - `contactDetailType.display` (string)
    Human-readable display

  - `contactId` (string, required)
    Identifier of the contact this detail belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this contact detail is currently active.

  - `isPreferred` (boolean, required)
    Whether this is the preferred contact detail of its type for the contact.

  - `name` (string, required)
    Label or type name for the contact detail (e.g. 'Home phone', 'Email').

  - `subscriptionGroups` (array, required)
    Identifiers of communication subscription groups associated with this contact detail.

  - `value` (string, required)
    Raw value of the contact detail (e.g. phone number, email address).

  - `valueCleaned` (string,null)
    System-normalized representation of the value, if available.

## Response 200 fields (application/json):

  - `contactDetailId` (string, required)
    Canonical identifier for this contact detail.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactDetailType` (object, required)
    Coded type of the contact detail (e.g. phone, email).

  - `contactDetailType.code` (string, required)
    Code value

  - `contactDetailType.system` (string, required)
    Code system URI

  - `contactDetailType.display` (string)
    Human-readable display

  - `contactId` (string, required)
    Identifier of the contact this detail belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `createdAt` (string, required)
    Timestamp when this contact detail was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether this contact detail is currently active.

  - `isPreferred` (boolean, required)
    Whether this is the preferred contact detail of its type for the contact.

  - `name` (string, required)
    Label or type name for the contact detail (e.g. 'Home phone', 'Email').

  - `subscriptionGroups` (array, required)
    Identifiers of communication subscription groups associated with this contact detail.

  - `updatedAt` (string, required)
    Timestamp when this contact detail was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `value` (string, required)
    Raw value of the contact detail (e.g. phone number, email address).

  - `valueCleaned` (string,null, required)
    System-normalized representation of the value, if available.


## Response 400 fields

## Response 401 fields

## Response 404 fields