---
title: "Update Interaction"
method: PATCH
path: "/interactions/{id}"
tags: ["Interactions"]
---

# Update Interaction

`PATCH /interactions/{id}`

Modifies an existing interaction by updating specific fields without overwriting the entire record.

## Path parameters

- `id` string, uuid, required

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Request body

- InteractionsUpdateRequest
  - `assignedUserId` string, uuid
  - `encounter` InteractionsEncounterUpdateRequest
    - `identifier` string — A unique identifier for the encounter, essential for tracking and referencing specific patient interactions.
    - `status` 'planned' | 'in-progress' | 'on-hold' | 'completed' | 'cancelled' | 'deleted'
    - `type` 'first_consultation' | 'consultation' | 'emergency' | 'inpatient' | 'outpatient'
    - `period` InteractionsEncounterPeriod
      - `startedAt` string, date-time, required — The start date/time of the encounter. (UTC)
      - `endedAt` string, date-time, nullable — The end date/time of the encounter. (UTC)
    - `title` string, nullable — A readable name for the interaction
  - `patient` InteractionsPatient
    - `identifier` string, required — FHIR reference to patient identifier.
    - `name` string, nullable — FHIR reference to Text representation of the full name.
    - `gender` 'male' | 'female' | 'unknown' | 'other'
    - `birthDate` string, date-time, nullable — FHIR reference to patient birth date.
    - `pronouns` string, nullable — FHIR reference to patient extension Individual Pronouns.

## Response `200`

A request body containing the fields to update within the interaction.

- InteractionsGetResponse
  - `id` string, uuid, required
  - `assignedUserId` string, uuid, required
  - `encounter` InteractionsEncounterResponse, required
    - `identifier` string, required — A unique identifier for the encounter, essential for tracking and referencing specific patient interactions.
    - `status` 'planned' | 'in-progress' | 'on-hold' | 'completed' | 'cancelled' | 'deleted', required
    - `type` 'first_consultation' | 'consultation' | 'emergency' | 'inpatient' | 'outpatient', required
    - `period` InteractionsEncounterPeriod, required
      - `startedAt` string, date-time, required — The start date/time of the encounter. (UTC)
      - `endedAt` string, date-time, nullable — The end date/time of the encounter. (UTC)
    - `title` string, nullable — A readable name for the interaction
  - `patient` InteractionsPatient, required
    - `identifier` string, required — FHIR reference to patient identifier.
    - `name` string, nullable — FHIR reference to Text representation of the full name.
    - `gender` 'male' | 'female' | 'unknown' | 'other'
    - `birthDate` string, date-time, nullable — FHIR reference to patient birth date.
    - `pronouns` string, nullable — FHIR reference to patient extension Individual Pronouns.
  - `endedAt` string, date-time, nullable — The timestamp when the interaction concluded (UTC).
  - `createdAt` string, date-time, required — The timestamp when the interaction was started (UTC).
  - `updatedAt` string, date-time, required — The timestamp when the interaction was last modified (UTC).
  - `websocketUrl` string, required — WebSocket URL for streaming real-time interactions. Append a token in the format: /interactions/{interactionID}/streams?token=Bearer token-value-here
  - `lastUpdated` string, date-time, required — The timestamp indicating the last recorded update for this interaction.

## Other responses

- `403` — RFC9457
- `504` — RFC9457

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/revisions/5d1895a1b3fc/schema)