# Replace breed

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

Endpoint: PUT /site/{siteId}/ahds/v1/breed/{breedId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `breedId` (string, required)
    Breed unique identifier (UUID)

## Request fields (application/json):

  - `extensions` (object, required)
    Vendor- or practice-specific extensions. Keys SHOULD be namespaced (e.g., vendorName.extensionName) to avoid collisions. Values SHOULD be primitive JSON types or small nested objects that do not duplicate core AHDS fields.

  - `isActive` (boolean, required)
    Whether this breed is currently active and can be selected for new records in the system. Inactive breeds should remain for historical/reference purposes but should not be used for new assignments.

  - `name` (string, required)
    Human-readable name of the breed.

  - `speciesId` (string, required)
    Reference to the species this breed belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `code` (object, required)
    Primary coded representation of the breed using the AHDS CodeableConcept pattern (e.g., standardized breed code from a terminology such as SNOMED CT or a veterinary breed registry).

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

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

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

  - `breedCode` (object, required)
    Primary coded representation of the breed using a CodeableConcept structure. Intended for interoperable coding of breeds across systems and terminologies.

## Response 200 fields (application/json):

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

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

  - `extensions` (object, required)
    Vendor- or practice-specific extensions. Keys SHOULD be namespaced (e.g., vendorName.extensionName) to avoid collisions. Values SHOULD be primitive JSON types or small nested objects that do not duplicate core AHDS fields.

  - `isActive` (boolean, required)
    Whether this breed is currently active and can be selected for new records in the system. Inactive breeds should remain for historical/reference purposes but should not be used for new assignments.

  - `name` (string, required)
    Human-readable name of the breed.

  - `speciesId` (string, required)
    Reference to the species this breed belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

  - `code` (object, required)
    Primary coded representation of the breed using the AHDS CodeableConcept pattern (e.g., standardized breed code from a terminology such as SNOMED CT or a veterinary breed registry).

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

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

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

  - `breedCode` (object, required)
    Primary coded representation of the breed using a CodeableConcept structure. Intended for interoperable coding of breeds across systems and terminologies.


## Response 400 fields

## Response 401 fields

## Response 404 fields