Functional standard / People / Instance
CareTeamMember
A person who cares in a role other than primary clinician: nurse, coordinator, health worker, dietitian.
- Kind
- care_team_member
- Collection
- /v1/care-team-members
- Initial state
- active
- Classification
- Operational
Scope and usage
Directory entry with the roles they may fill.
Boundaries and relationships
- The primary clinical decision-maker is a Provider.
- Membership of a patient's team is CareTeam, not this directory row.
Resource content
Elements this resource adds. It also carries the Instance.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| name | 1..1 | string | — | Display name. |
| skills | 0..* | string | — | Skills used when matching a team role. |
| roles | 0..* | code | — | Roles this person may fill, such as nurse or coordinator. |
| reports_to | 0..1 | id | — | A Provider or CareTeamMember id. |
| user_id | 0..1 | id | — | Matching actor id. |
State machine
active/ initial — Available.in_break— Temporarily unavailable.resigned— Left the site.
active → in_break, resigned. in_break → active, resigned.
Frozen: None. Not deletable.
Invariants
No invariant beyond the common operation rules.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/care-team-members | List care team member. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/care-team-members | Create a care team member. Body is the resource minus harness-owned elements. |
| GET | /v1/care-team-members/{id} | Read one care team member. |
| PATCH | /v1/care-team-members/{id} | Update elements that are not immutable, frozen, or harness-owned. |
| POST | /v1/care-team-members/{id}/transition | Move status. Body is { to, reason }. A gated move returns 202 and an Approval. |
Example
{ "name": "Nurse Iyer", "roles": ["nurse"], "user_id": "nurse_iyer" }