Clinical Intelligence StandardsVersion 0.2

Functional standard / People / PatientInstance

CareTeam

The roster actually caring for one patient. The primary provider is the member whose role is primary.

Kind
care_team
Collection
/v1/care-teams
Initial state
active
Classification
Operational

Scope and usage

One team per patient engagement, shaped by a care_team Definition. A slot may be limited to a single encounter.

Boundaries and relationships

Resource content

Elements this resource adds. It also carries the Instance, including patient_id.

NameCard.TypeFlagsDescription
name1..1string—Defaults to Care team.
members0..*TeamSlot—person_id, person_kind (provider | care_team_member), role, optional encounter_id, since.

State machine

active → disbanded.

Frozen: None.

Terminology bindings

ElementStrengthValues
members.rolerequiredA role key from the care_team definition. primary is the primary care provider.

Invariants

Operations

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

Notes

Example

{ "patient_id": "pat_…", "definition_key": "care_team_standard", "members": [{ "person_id": "prv_…", "person_kind": "provider", "role": "primary" }] }