Clinical Intelligence StandardsVersion 0.2

Functional standard / Interactions / Instance

Conversation

A conversation with an agent, about one patient or general. Turns can carry proposal ids.

Kind
conversation
Collection
/v1/conversations
Initial state
open
Classification
Operational

Scope and usage

The actor's role selects the conversation definition: clinician copilot, patient coach, coordinator. Reading a patient's conversation requires ai consent.

Boundaries and relationships

Resource content

Elements this resource adds. It also carries the Instance.

NameCard.TypeFlagsDescription
patient_id0..1id—Required in spirit when scope is patient. Omitted for general.
scope1..1codeBpatient or general.
actor_role1..1code—Whose conversation: clinician, patient, coordinator.
title1..1string—Title.
structure0..1object—Copied from the definition. Sections and tone.
turns0..*TurnRid, speaker, content, at, proposal ids. Harness-owned.

State machine

open → closed.

Frozen: closed.

Invariants

Operations

MethodPathMeaning
GET/v1/conversationsList conversation. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/conversationsCreate a conversation. Body is the resource minus harness-owned elements.
GET/v1/conversations/{id}Read one conversation.
PATCH/v1/conversations/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/conversations/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.
DELETE/v1/conversations/{id}?reason=Soft-delete. Reason is required. Refused when the resource is not deletable or is frozen.
POST/v1/conversations/{id}/turnsAppend a turn. Body is { content }.

Notes

Example

{ "patient_id": "pat_…", "scope": "patient", "actor_role": "clinician", "definition_key": "conversation_clinician_copilot" }