Functional standard / Governance / PatientInstance
Consent
Permission for one scope: treatment, data sharing, AI, procedure, communication, or research.
- Kind
- consent
- Collection
- /v1/consents
- Initial state
- requested
- Classification
- Operational
Scope and usage
Granted by the patient or by a guardian within the relationship's scopes. Sharing a document checks data_sharing. An agent checks ai.
Boundaries and relationships
- A consent form file is a ClinicalDocument. This resource is the decision.
- Connectors that export data must check data_sharing. The map of fields is not a substitute.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| consent_scope | 1..1 | code | B | One of the six scopes. |
| granted_by | 1..1 | code | B | self or guardian. |
| guardian_id | 0..1 | id | — | Required in practice when granted_by is guardian. |
| document_id | 0..1 | id | — | Signed form, a ClinicalDocument. |
| valid_until | 0..1 | dateTime | — | Optional end. |
| details | 0..1 | string | — | What was explained. |
State machine
requested/ initial — Asked, not answered.granted— In force until withdrawn or expired.refused— Declined. Frozen.withdrawn— Taken back. Frozen.expired— Past valid_until. Frozen.
requested → granted, refused. granted → withdrawn, expired.
Frozen: refused, withdrawn, and expired.
Terminology bindings
| Element | Strength | Values |
|---|---|---|
| consent_scope | required | treatment | data_sharing | ai | procedure | communication | research |
Invariants
ccs-con-1— A guardian may grant only scopes on an active Relationship.ccs-con-2— data_sharing gates document share and any connector export of clinical fields.ccs-con-3— ai gates agent read, draft, and propose for that patient.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/consents | List consent. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/consents | Create a consent. Body is the resource minus harness-owned elements. |
| GET | /v1/consents/{id} | Read one consent. |
| PATCH | /v1/consents/{id} | Update elements that are not immutable, frozen, or harness-owned. |
| POST | /v1/consents/{id}/transition | Move status. Body is { to, reason }. A gated move returns 202 and an Approval. |
Example
{ "patient_id": "pat_…", "consent_scope": "ai", "granted_by": "self" }