# Replace with primary inventory location

Fully replaces an existing With Primary Inventory Location. All fields must be provided.

Endpoint: PUT /site/{siteId}/ahds/v1/with-primary-inventory-location/{separationId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `separationId` (string, required)
    With Primary Inventory Location unique identifier (UUID)

## Request fields (application/json):

  - `childSeparationId` (string, required)
    Identifier of the child separation, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Identifier of the associated contact entity, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

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

  - `name` (string, required)
    Human-readable name of the separation (e.g., clinic or department name).

  - `parentSeparationId` (string, required)
    Identifier of the parent separation, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `primaryInventoryLocationId` (string, required)
    Identifier of the primary inventory location associated with this separation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationCategory` (string, required)
    High-level category of the separation (e.g., division, department).
    Enum: "division", "department", "location", "other"

  - `separationType` (string, required)
    Free-text type or classification of the separation as used in the source system.

## Response 200 fields (application/json):

  - `childSeparationId` (string, required)
    Identifier of the child separation, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Identifier of the associated contact entity, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

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

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

  - `name` (string, required)
    Human-readable name of the separation (e.g., clinic or department name).

  - `parentSeparationId` (string, required)
    Identifier of the parent separation, if any.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `primaryInventoryLocationId` (string, required)
    Identifier of the primary inventory location associated with this separation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationCategory` (string, required)
    High-level category of the separation (e.g., division, department).
    Enum: "division", "department", "location", "other"

  - `separationId` (string, required)
    Canonical identifier for the separation (e.g., division, department).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationType` (string, required)
    Free-text type or classification of the separation as used in the source system.

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


## Response 400 fields

## Response 401 fields

## Response 404 fields