# Replace herd

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

Endpoint: PUT /site/{siteId}/ahds/v1/herd/{herdId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `herdId` (string, required)
    Herd unique identifier (UUID)

## Request fields (application/json):

  - `name` (string, required)
    Human-readable name or identifier for the herd.

  - `herdType` (object, required)
    Type of herd (cattle, sheep, swine, poultry).

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

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

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

  - `ownerId` (string, required)
    Reference to the contact who owns this herd.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `locationId` (string, required)
    Reference to the primary location where the herd is kept.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `estimatedCount` (number, required)
    Estimated number of animals in the herd.

  - `isActive` (boolean, required)
    Whether the herd is currently active.

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

## Response 200 fields (application/json):

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

  - `name` (string, required)
    Human-readable name or identifier for the herd.

  - `herdType` (object, required)
    Type of herd (cattle, sheep, swine, poultry).

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

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

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

  - `ownerId` (string, required)
    Reference to the contact who owns this herd.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `locationId` (string, required)
    Reference to the primary location where the herd is kept.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `estimatedCount` (number, required)
    Estimated number of animals in the herd.

  - `isActive` (boolean, required)
    Whether the herd is currently active.

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

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

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


## Response 400 fields

## Response 401 fields

## Response 404 fields