Clinical Intelligence StandardsVersion 0.2

Functional standard / What can be done / PatientInstance

CohortMembership

The patient is in a cohort. Entry and exit run the cohort definition's actions.

Kind
cohort_membership
Collection
/v1/cohort-memberships
Initial state
active
Classification
Clinical

Scope and usage

Enrollment. The cohort rule may match automatically, but matching proposes membership. A person confirms it. Manual enrollment requires a reason.

Boundaries and relationships

Resource content

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

NameCard.TypeFlagsDescription
cohort_key1..1codeIDefinition key of kind cohort.
overridden1..1boolean—True when enrolled even though the rule did not match.
reason1..1string—Why, at least three characters.

State machine

active → closed.

Frozen: closed.

Invariants

Operations

MethodPathMeaning
GET/v1/cohort-membershipsList cohort membership. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/cohort-membershipsCreate a cohort membership. Body is the resource minus harness-owned elements.
GET/v1/cohort-memberships/{id}Read one cohort membership.
PATCH/v1/cohort-memberships/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/cohort-memberships/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.

Notes

Example

{ "patient_id": "pat_…", "cohort_key": "cohort_mdd", "reason": "Working diagnosis of MDD" }