# Replace separation

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

Endpoint: PUT /site/{siteId}/ahds/v1/separation/{separationId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `separationId` (string, required)
    Separation unique identifier (UUID)

## Request fields (application/json):

  - `category` (string, required)
    High-level category of separation.
    Enum: "ownership", "location", "grouping", "other"

  - `childEntityId` (string, required)
    Identifier of the child entity in the separation relationship (e.g., separated animal, destination group).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `clientProvidedId` (string, required)
    Optional client-supplied identifier for idempotency or cross-system correlation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Reference to the associated contact, if applicable.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

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

  - `name` (string, required)
    Human-readable name or label for the separation.

  - `parentEntityId` (string, required)
    Identifier of the parent entity in the separation relationship (e.g., owner, source group).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationType` (object, required)
    Specific type of separation as a coded concept.

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

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

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

## Response 200 fields (application/json):

  - `category` (string, required)
    High-level category of separation.
    Enum: "ownership", "location", "grouping", "other"

  - `childEntityId` (string, required)
    Identifier of the child entity in the separation relationship (e.g., separated animal, destination group).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `clientProvidedId` (string, required)
    Optional client-supplied identifier for idempotency or cross-system correlation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Reference to the associated contact, if applicable.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `createdAt` (string, required)
    Timestamp when this 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 record is currently active.

  - `name` (string, required)
    Human-readable name or label for the separation.

  - `parentEntityId` (string, required)
    Identifier of the parent entity in the separation relationship (e.g., owner, source group).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationId` (string, required)
    Canonical identifier for this separation relationship.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `separationType` (object, required)
    Specific type of separation as a coded concept.

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

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

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

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


## Response 400 fields

## Response 401 fields

## Response 404 fields