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
- People must already exist as Provider or CareTeamMember.
- Tasks are not members. Assignment of work is Task and Routine.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| name | 1..1 | string | — | Defaults to Care team. |
| members | 0..* | TeamSlot | — | person_id, person_kind (provider | care_team_member), role, optional encounter_id, since. |
State machine
active/ initial — The roster is in force.disbanded— The roster is closed.
active → disbanded.
Frozen: None.
Terminology bindings
| Element | Strength | Values |
|---|---|---|
| members.role | required | A role key from the care_team definition. primary is the primary care provider. |
Invariants
ccs-team-1— Exactly one member in the role primary, and that person is a Provider.ccs-team-2— Every role must exist on the definition. Per-encounter overrides are allowed.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/care-teams | List care team. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/care-teams | Create 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}/transition | Move 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
- Created from definition kind care_team.
Example
{ "patient_id": "pat_…", "definition_key": "care_team_standard", "members": [{ "person_id": "prv_…", "person_kind": "provider", "role": "primary" }] }