---
title: "Update Lab Interaction"
method: PATCH
path: "/provider/patients/{patient_id}/interactions/lab/{id}"
tags: ["LabInteraction"]
---

# Update Lab Interaction

`PATCH /provider/patients/{patient_id}/interactions/lab/{id}`

## Path parameters

- `patient_id` string, required
- `id` string, required

## Request body

- InteractionLabSanitizer
  - `status` 'sent' | 'fulfilled' — The status of the interaction. Defaults to "SENT"
  - `vendor_order_id` string — External vendor order ID (used for idempotency)
  - `event_timestamp` string, date-time — Defaults to current time
  - `order` InteractionLabSanitizerOrderSanitizer
    - `lab_reference_id` string — External reference ID for the lab order
    - `ordered_from` string — Lab provider name (e.g., "LabCorp")
    - `authored_on` string — When the order was authored
    - `collected_at` string, date-time — When the specimen was collected
    - `author` string — Name or ID of the ordering provider
    - `author_reference` string — Reference identifier for the author
    - `actions` InteractionLabSanitizerActionSanitizer[] — Ordered tests/panels
      - `reference` string, required — Reference code for the test
      - `display` string, required — Human-readable test name
    - `intent` string — Order intent
    - `subject` InteractionLabSanitizerSubjectSanitizer
      - `reference` string — Subject reference ID
      - `display` string — Subject display name
    - `lab_account_id` string — Lab account identifier
  - `report` InteractionLabSanitizerReportSanitizer
    - `issued` string, date-time, required — When the report was issued
    - `status` string, required — Report status (e.g., "final", "preliminary")
    - `lab_reference_id` string — External lab reference ID
    - `order_reference` string — Reference to the originating order
  - `results` InteractionLabSanitizerResultSanitizer[] — Lab result observations
    - `id` string, required — Unique result identifier
    - `code` InteractionLabSanitizerResultCodeSanitizer[], required — At least one coding entry (min 1)
      - `code` string, required — LOINC code value (only LOINC is supported)
      - `display` string, required — Human-readable name
    - `code_text` string, required — Human-readable name for the result
    - `issued` string, date-time, required — When the result was issued
    - `value_quantity` InteractionLabSanitizerResultQuantitySanitizer
      - `value` integer, required — The measured value
      - `unit` string, required — Unit of measure (e.g., "mg/dL")
    - `value_string` string — String result value
    - `text` string — Additional narrative text
    - `interpretation` string[] — Interpretation codes (e.g., ["normal"])
    - `ranges` InteractionLabSanitizerResultRangeSanitizer[] — Reference ranges
      - `low` InteractionLabSanitizerResultQuantitySanitizer
        - `value` integer, required — The measured value
        - `unit` string, required — Unit of measure (e.g., "mg/dL")
      - `high` InteractionLabSanitizerResultQuantitySanitizer
        - `value` integer, required — The measured value
        - `unit` string, required — Unit of measure (e.g., "mg/dL")
      - `text` string — Textual range description
    - `subject` string — Subject reference
  - `integration_record_id` string
  - `integration_error_message` string
  - `integration_web_link` string

## Response `200`

Successful response

- PublicInteractionLabBlueprintOne
  - `id` string
  - `event_timestamp` string, date-time
  - `patient_access` boolean
  - `status` string
  - `type` string
  - `vendor_order_id` string
  - `order` PublicInteractionLabOrderBlueprintLeaf
    - `lab_reference_id` string
    - `ordered_from` string
    - `authored_on` string
    - `collected_at` string
    - `author` string
    - `author_reference` string
    - `intent` string
    - `lab_account_id` string
    - `actions` PublicInteractionLabOrderActionBlueprintLeaf
      - `reference` string
      - `display` string
    - `subject` PublicInteractionLabOrderSubjectBlueprintLeaf
      - `reference` string
      - `display` string
  - `report` PublicInteractionLabReportBlueprintLeaf
    - `issued` string
    - `status` string
    - `lab_reference_id` string
    - `order_reference` string
  - `results` PublicInteractionLabResultBlueprintLeaf
    - `id` string
    - `code_text` string
    - `issued` string
    - `value_string` string
    - `text` string
    - `interpretation` string
    - `subject` string
    - `code` PublicInteractionLabResultCodeBlueprintLeaf
      - `code` string
      - `display` string
    - `value_quantity` PublicInteractionLabResultQuantityBlueprintLeaf
      - `value` string
      - `unit` string
    - `ranges` PublicInteractionLabResultRangeBlueprintLeaf
      - `text` string
      - `low` PublicInteractionLabResultQuantityBlueprintLeaf
        - `value` string
        - `unit` string
      - `high` PublicInteractionLabResultQuantityBlueprintLeaf
        - `value` string
        - `unit` string

---

[API](https://skmtc.net/hint/apis/partner-endpoints.md) · [All operations](https://skmtc.net/hint/apis/partner-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hint/partner-endpoints/revisions/a92ae2a6fa90/schema)