---
title: "Update Dose"
method: PUT
path: "/user/patient/doses/{dose_id}"
tags: ["provider", "user", "doses"]
---

# Update Dose

`PUT /user/patient/doses/{dose_id}`

Update an existing dose record. Updating a dose will unsign it, requiring re-approval.

## Path parameters

- `dose_id` string, required

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- DoseUpdate — Schema for updating an existing dose record.
  - `doseDate` string, date-time, nullable
  - `name` string, nullable
  - `unit` string, nullable
  - `sideEffects` string, nullable
  - `administrationLocation` string, nullable
  - `amount` number, nullable
  - `quantity` number, nullable
  - `frequency` string, nullable
  - `comment` string, nullable
  - `lotNumber` string, nullable
  - `stockId` string, nullable
  - `noteId` string, nullable
  - `signedOffProviderId` string, nullable
  - `signedOffDate` string, date-time, nullable

## Response `200`

Successful Response

- DoseSummary — Schema for returning dose information with computed fields.
  - `medicationId` string, required
  - `patientId` string, required
  - `providerId` string, nullable
  - `doseDate` string, date-time, nullable
  - `name` string, nullable
  - `unit` string, nullable
  - `sideEffects` string, nullable
  - `administrationLocation` string, nullable
  - `amount` number, nullable
  - `quantity` number
  - `frequency` string, nullable
  - `comment` string, nullable
  - `lotNumber` string, nullable
  - `stockId` string, nullable
  - `noteId` string, nullable
  - `signedOffProviderId` string, nullable
  - `signedOffDate` string, date-time, nullable
  - `isArchived` boolean
  - `id` string, required
  - `createdDate` string, date-time, required
  - `updatedDate` string, date-time, nullable
  - `provider` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.
  - `signedOffProvider` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)