---
title: "Update Session"
method: PATCH
path: "/voice/v1/sessions/{session_id}"
tags: ["sessions"]
---

# Update Session

`PATCH /voice/v1/sessions/{session_id}`

Update a session's metadata before it is committed. Use this to attach or correct `patient_details`, change the requested `templates`, adjust `language_hint`, or switch `session_mode` / `model`. `session_mode` and `model` can only be changed while the session is still open (before End Session) — attempting to change them afterwards returns `409`. Unknown fields are rejected.

## Path parameters

- `session_id` string, required

## Request body

- PatchSessionRequest
  - `patient_details` object — Patient demographic / identifier metadata. The `oid` key is promoted to `patient_oid` for indexing.
  - `templates` string[] — Replace the requested template IDs (up to 2).
  - `language_hint` string[] — ISO 639-1 code(s) hinting the spoken language(s).
  - `additional_data` object — Arbitrary pass-through metadata merged into the session.
  - `session_mode` 'consultation' | 'dictation' — Updatable only before the session is committed (End Session).
  - `model` 'pro' | 'lite' — Updatable only before the session is committed (End Session).
  - `user_status` string — Client-side session status marker.
  - `processing_status` string — Processing status override (advanced use).

## Response `200`

Session updated

- PatchSessionResponse
  - `session_id` string
  - `status` string
  - `message` string

## Other responses

- `404` — Session not found
- `409` — session_mode / model can no longer be changed (session already committed)
- `422` — Validation error (unknown or invalid fields)

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)