Clinical Intelligence StandardsVersion 0.2

Functional standard / What is being done / Instance

Task

Work for the care team: a checklist, or a request to complete a note or an assessment.

Kind
task
Collection
/v1/tasks
Initial state
open
Classification
Operational

Scope and usage

May be tied to a patient, a plan, an encounter, a person, or a role. Routines generate tasks when they fall due.

Boundaries and relationships

Resource content

Elements this resource adds. It also carries the Instance.

NameCard.TypeFlagsDescription
patient_id0..1id—Patient, when the task is about one.
title1..1string—What to do.
careplan_id0..1id—Plan that spawned it.
encounter_id0..1id—Encounter.
assignee_role0..1code—Role that should do it.
usage_id0..1id—Reference to a calculator or assessment run, when there is one.
assignee_id0..1id—Specific person.
due_at0..1dateTime—Due time.
checklist0..*ChecklistItem—item and done.
target_kind0..1code—Resource this task asks for, such as assessment or note_page.
target_definition_key0..1code—Definition to use.
target_id0..1idRFilled when that record exists.
routine_id0..1id—Routine that generated this occurrence.
occurrence0..1dateTime—Which occurrence.
priority1..1codeBlow, normal, high, or urgent.

State machine

open → in_progress, done, cancelled. in_progress → open, done, cancelled.

Frozen: done and cancelled.

Terminology bindings

ElementStrengthValues
priorityrequiredlow | normal | high | urgent

Invariants

No invariant beyond the common operation rules.

Operations

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

Notes

Example

{ "patient_id": "pat_…", "title": "Call after the new prescription", "assignee_role": "nurse", "priority": "normal" }