# Update animal

Partially updates an existing Animal. Only provided fields will be updated.

Endpoint: PATCH /site/{siteId}/ahds/v1/animal/{animalId}
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

  - `animalId` (string, required)
    Animal unique identifier (UUID)

## Request fields (application/json):

  - `breed` (object)
    Animal breed, represented as a CodeableConcept-like structure.

  - `code` (string,null)
    Practice-specific animal code or chart number.

  - `colour` (object)
    Animal colour.

  - `deathReason` (string,null)
    Free-text reason for death.

  - `desexDate` (string,null)
    Date the animal was desexed (spayed/neutered). No time component is required.
    Example: "2025-01-01"

  - `extensions` (object)
    Vendor- or practice-specific extension fields.

  - `hasImportantNotes` (boolean)
    True if notes contain important or highlighted information.

  - `isActive` (boolean)
    Whether the animal record is active in the source system.

  - `isDead` (boolean)
    Whether the animal is deceased. Should be consistent with deathDate when present.

  - `isEstimatedDateOfBirth` (boolean,null)
    True if the date of birth is estimated rather than exact.

  - `isHostile` (boolean)
    Whether the animal is marked as hostile or aggressive.

  - `microchipNumber` (string,null)
    Microchip identifier.

  - `name` (string)
    Animal's name.

  - `notes` (string,null)
    General clinical or administrative notes about the animal.

  - `ownerContactId` (string)
    Canonical identifier of the primary owner contact.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `rabiesNumber` (string,null)
    Rabies vaccination certificate or tag number.

  - `rabiesVaccinationDate` (string,null)
    Date of last rabies vaccination.
    Example: "2025-01-01"

  - `referringClinicId` (string,null)
    Canonical identifier of the referring clinic.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `referringVetId` (string,null)
    Canonical identifier of the referring veterinarian.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `residenceContactId` (string,null)
    Canonical identifier of the residence contact (if different from owner).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resuscitationStatus` (string)
    Resuscitation preference for the animal.
    Enum: "full", "do_not_resuscitate", "unspecified"

  - `sex` (object)
    Administrative sex of the animal.

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

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

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

  - `species` (object)
    Animal species.

  - `weight` (object,null)
    Most recent recorded body weight.

  - `weight.value` (number, required)
    Numeric value

  - `weight.unit` (string, required)
    Unit of measure

  - `weight.system` (string)
    Unit system URI

  - `herdId` (string)
    Optional herd identifier for production animals.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `birthDate` (string,null)
    Date of birth.
    Example: "2025-01-01"

  - `deathDate` (string,null)
    Date of death (no time component).
    Example: "2025-01-01"

## Response 200 fields (application/json):

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

  - `breed` (object, required)
    Animal breed, represented as a CodeableConcept-like structure.

  - `code` (string,null, required)
    Practice-specific animal code or chart number.

  - `colour` (object, required)
    Animal colour.

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

  - `deathReason` (string,null, required)
    Free-text reason for death.

  - `desexDate` (string,null, required)
    Date the animal was desexed (spayed/neutered). No time component is required.
    Example: "2025-01-01T00:00:00Z"

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

  - `hasImportantNotes` (boolean, required)
    True if notes contain important or highlighted information.

  - `isActive` (boolean, required)
    Whether the animal record is active in the source system.

  - `isDead` (boolean, required)
    Whether the animal is deceased. Should be consistent with deathDate when present.

  - `isEstimatedDateOfBirth` (boolean,null, required)
    True if the date of birth is estimated rather than exact.

  - `isHostile` (boolean, required)
    Whether the animal is marked as hostile or aggressive.

  - `microchipNumber` (string,null, required)
    Microchip identifier.

  - `name` (string, required)
    Animal's name.

  - `notes` (string,null, required)
    General clinical or administrative notes about the animal.

  - `ownerContactId` (string, required)
    Canonical identifier of the primary owner contact.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `rabiesNumber` (string,null, required)
    Rabies vaccination certificate or tag number.

  - `rabiesVaccinationDate` (string,null, required)
    Date of last rabies vaccination.
    Example: "2025-01-01T00:00:00Z"

  - `referringClinicId` (string,null, required)
    Canonical identifier of the referring clinic.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `referringVetId` (string,null, required)
    Canonical identifier of the referring veterinarian.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `residenceContactId` (string,null, required)
    Canonical identifier of the residence contact (if different from owner).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resuscitationStatus` (string, required)
    Resuscitation preference for the animal.
    Enum: "full", "do_not_resuscitate", "unspecified"

  - `sex` (object, required)
    Administrative sex of the animal.

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

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

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

  - `species` (object, required)
    Animal species.

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

  - `weight` (object,null, required)
    Most recent recorded body weight.

  - `weight.value` (number, required)
    Numeric value

  - `weight.unit` (string, required)
    Unit of measure

  - `weight.system` (string)
    Unit system URI

  - `herdId` (string, required)
    Optional herd identifier for production animals.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `birthDate` (string,null, required)
    Date of birth.
    Example: "2025-01-01T00:00:00Z"

  - `deathDate` (string,null, required)
    Date of death (no time component).
    Example: "2025-01-01T00:00:00Z"


## Response 400 fields

## Response 401 fields

## Response 404 fields