Clinical Intelligence StandardsVersion 0.2

Functional standard / Governance / Instance

Approval

A request to enter a gated state. Someone other than the requester decides.

Kind
approval
Collection
/v1/approvals
Initial state
pending
Classification
Operational

Scope and usage

Created by the harness when a transition targets an approval state, or a definition lists approval_required_for. There is no create operation for callers.

Boundaries and relationships

Resource content

Elements this resource adds. It also carries the Instance.

NameCard.TypeFlagsDescription
patient_id0..1id—Patient, when the subject has one.
subject_kind1..1code—Resource being gated.
subject_id1..1id—That record.
to_state1..1code—The state that was requested.
reason0..1string—Why the requester asked.
decided_by0..1idRHarness-owned.
decision_note0..1stringRHarness-owned.

State machine

Decided only through /decide, not the generic transition.

Frozen: approved and rejected.

Invariants

Operations

MethodPathMeaning
GET/v1/approvalsList approvals.
GET/v1/approvals/{id}Read one.
POST/v1/approvals/{id}/decideBody is { approve, note }.

Example

{ "subject_kind": "note_page", "subject_id": "page_…", "to_state": "approved", "reason": "Please countersign" }