---
title: "Full prescription edit. Pre-Dispensed prescriptions are updated in place;
Dispensed prescriptions require a `reason` and the change is recorded
as an amendment. DEA-tracked field changes on a controlled substance are
blocked — caller must cancel-and-recreate instead."
method: PATCH
path: "/rx/governance/{id}"
tags: ["RxGovernance"]
---

# Full prescription edit. Pre-Dispensed prescriptions are updated in place;
Dispensed prescriptions require a `reason` and the change is recorded
as an amendment. DEA-tracked field changes on a controlled substance are
blocked — caller must cancel-and-recreate instead.

`PATCH /rx/governance/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdatePrescriptionDto — Full prescription edit payload. Every editable field is nullable — only the supplied properties are applied. When the prescription has already been dispensed, string? UpdatePrescriptionDto.Reason is required and the edit lands as a `PrescriptionAmendment` rather than mutating the original item.
  - `medicationName` string, nullable
  - `inventoryItemId` string, nullable
  - `dosage` string, nullable
  - `quantity` union
    - number, double
    - string, double
  - `unit` string, nullable
  - `frequency` string, nullable
  - `duration` string, nullable
  - `instructions` string, nullable
  - `refillsAllowed` union
    - integer
    - string, int32
  - `notes` string, nullable
  - `reason` string, nullable — Required for post-Dispensed amendments; ignored otherwise.

## Response `200`

OK

- RxGovernanceDto
  - `id` string
  - `createdDate` string
  - `patientName` string
  - `species` string
  - `clientName` string
  - `medication` string
  - `medicationId` string, nullable
  - `medicationCategory` string, nullable
  - `deaSchedule` string, nullable
  - `strength` string, nullable
  - `provider` string
  - `status` string
  - `guardrails` GuardrailChecksDto
    - `dose` boolean
    - `interaction` boolean
    - `allergy` boolean
  - `events` RxEventDto[]
    - `type` string
    - `timestamp` string, date-time
    - `actor` string
    - `data` object, nullable
  - `routing` RxRoutingDto
    - `id` string
    - `method` string
    - `pharmacyId` string, nullable
    - `pharmacyName` string, nullable
    - `inventoryLotId` string, nullable
    - `trackingNumber` string, nullable
    - `estimatedDeliveryTime` string, nullable
    - `notes` string, nullable
    - `routedAt` string, date-time
    - `routedBy` string, nullable
  - `lastExamDate` string, nullable — Patient's last exam date (VCPR - Veterinary-Client-Patient Relationship)
  - `patientId` string, nullable
  - `prescriptionItemId` string, nullable
  - `quantity` union
    - number, double
    - string, double
  - `transactionId` string, nullable
  - `invoiceLineItemId` string, nullable — Set when the dispense-from-inventory call included an InvoiceId and a line item was created atomically with the dispense. Lets clients append the line item locally without refetching.
  - `invoiceId` string, nullable — The estimate the dispense was attached to — either the one the caller supplied or one auto-created/resolved server-side. Lets a client that had no estimate of its own adopt the server's estimate instead of failing to reconcile the line.
  - `dosage` string, nullable
  - `frequency` string, nullable
  - `duration` string, nullable
  - `instructions` string, nullable
  - `prescriberLicenseNumber` string, nullable
  - `distributionCategorySnapshot` string, nullable
  - `isCascade` boolean
  - `cascadeReason` string, nullable
  - `antimicrobialUseType` string, nullable
  - `antimicrobialJustification` string, nullable
  - `clinicalAssessmentPerformed` boolean
  - `physicalExamPerformed` boolean
  - `physicalExamJustification` string, nullable
  - `validUntil` string, nullable — ISO date string (YYYY-MM-DD).
  - `repeatCount` union
    - integer
    - string, int32
  - `withdrawalPeriod` string, nullable

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/versions/a905bde4e796/schema)