# Replace modality

Fully replaces an existing Modality. All fields must be provided.

Endpoint: PUT /site/{siteId}/ahds/v1/modality/{modalityId}
Version: 1.0
Security: bearer

## Security:

  - `bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `modalityId` (string, required)
    Modality unique identifier (UUID)

## Request fields (application/json):

  - `code` (string, required)
    Practice- or system-specific code for the modality (e.g., 'XR', 'US').
    Example: CODE-001

  - `description` (string)
    Optional description of the modality.
    Example: Example description

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

  - `isActive` (boolean, required)
    Indicates whether this modality is active and can be used.
    Example: true

  - `name` (string, required)
    Human-readable name of the modality.
    Example: Example Name

## Response 200:

  - `200` (unknown)
    Modality replaced successfully

## Response 200 fields (application/json):

  - `code` (string, required)
    Practice- or system-specific code for the modality (e.g., 'XR', 'US').
    Example: CODE-001

  - `description` (string, required)
    Optional description of the modality.
    Example: Example description

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

  - `isActive` (boolean, required)
    Indicates whether this modality is active and can be used.
    Example: true

  - `modalityId` (string, required)
    Canonical unique identifier for the modality.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `name` (string, required)
    Human-readable name of the modality.
    Example: Example Name

## Response 400:

  - `400` (unknown)
    Invalid request body

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 404:

  - `404` (unknown)
    Modality not found

