---
title: "Update a dispensed item's dispense type and prescription details"
method: PATCH
path: "/Appointments/{id}/dispensed-items/{transactionId}"
tags: ["Appointments"]
---

# Update a dispensed item's dispense type and prescription details

`PATCH /Appointments/{id}/dispensed-items/{transactionId}`

## Path parameters

- `id` string, required
- `transactionId` string, required

## Request body

- UpdateDispensedItemDto — DTO for updating a dispensed item's dispense type and prescription details
  - `dispenseType` string — Type of dispense: InHouse or Prescription
  - `dosage` string, nullable
  - `frequency` string, nullable
  - `duration` string, nullable
  - `instructions` string, nullable
  - `refillsAllowed` union
    - integer
    - string, int32

## Response `200`

OK

- DispensedItemDto — Canonical shape for a dispensed inventory item. Used for both appointment-scoped ("what was dispensed during this appointment?") and patient-scoped ("what has been dispensed for this patient that isn't on an invoice yet?") queries.
  - `transactionId` string
  - `inventoryItemId` string
  - `itemName` string
  - `sku` string, nullable
  - `category` string
  - `quantity` union
    - number, double
    - string, double
  - `unitCost` union
    - number, double
    - string, double
  - `calculatedPrice` union
    - number, double
    - string, double
  - `dispenseFee` union
    - number, double
    - string, double
  - `pricePolicy` string
  - `isTaxable` boolean
  - `lotNumber` string, nullable
  - `transactionDate` string, date-time
  - `notes` string, nullable
  - `markedForBilling` boolean — Whether this item is marked for billing (should appear on invoice). User-controlled toggle for samples, comped items, etc.
  - `isOnInvoice` boolean — Whether this item has already been added to an invoice (InvoiceLineItem exists).
  - `invoiceLineItemId` string, nullable
  - `dispenseType` string — Type of dispense: InHouse (administered now) or Prescription (take-home).
  - `prescriptionId` string, nullable
  - `dosage` string, nullable
  - `frequency` string, nullable
  - `refillsRemaining` union
    - integer
    - string, int32
  - `appointmentId` string, nullable — The appointment this dispense is tied to, if any. Null for walk-in/OTC dispenses made outside an appointment context.
  - `patientId` 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)