# Update contact association

Partially updates an existing Contact Association. Only provided fields will be updated.

Endpoint: PATCH /site/{siteId}/ahds/v1/contact-association/{contactAssociationId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `contactAssociationId` (string, required)
    Contact Association unique identifier (UUID)

## Request fields (application/json):

  - `associatedContactId` (string)
    Associated/related contact.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `associationClass` (string)
    Classification of the relationship between the contacts.
    Enum: "family", "other"

  - `contactId` (string)
    Primary contact in the association.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object)
    Vendor- or practice-specific extension fields.

  - `isActive` (boolean)
    Whether this association is currently active.

  - `associationType` (object)
    Directionality/role of this contact in the association (e.g., owner-of, emergency-contact-for).

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

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

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

## Response 200 fields (application/json):

  - `associatedContactId` (string, required)
    Associated/related contact.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `associationClass` (string, required)
    Classification of the relationship between the contacts.
    Enum: "family", "other"

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

  - `contactId` (string, required)
    Primary contact in the association.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

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

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

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

  - `associationType` (object, required)
    Directionality/role of this contact in the association (e.g., owner-of, emergency-contact-for).

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

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

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


## Response 400 fields

## Response 401 fields

## Response 404 fields