# 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

## Security:

  - `bearer` (unknown)
    http bearer JWT

## 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.
    Example: true

  - `name` (string, required)
    Human-readable name of the separation (e.g., clinic or department name).
    Example: Example 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.
    Example: example

## Response 200:

  - `200` (unknown)
    With Primary Inventory Location replaced successfully

## 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.
    Example: true

  - `name` (string, required)
    Human-readable name of the separation (e.g., clinic or department name).
    Example: Example 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.
    Example: example

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

## Response 400:

  - `400` (unknown)
    Invalid request body

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 404:

  - `404` (unknown)
    With Primary Inventory Location not found

