Clinical Intelligence StandardsVersion 0.2

Functional standard / Foundation

Operations

Five operations on every resource, plus a short list of named operations. This is the REST surface, in the same role as FHIR's HTTP API.

OperationHTTPRefuses when
createPOST /v1/{plural}Validation fails, the actor's role cannot write, an agent targets a resource they may not draft, or a clinical create is attempted by anyone but a clinician
readGET /v1/{plural}/{id}Wrong site, or a patient actor outside the people they represent, or an agent without ai consent
listGET /v1/{plural}Same as read. Filters: patient_id, status, encounter_id, definition_key
updatePATCH /v1/{plural}/{id}Frozen, immutable element, harness-owned element, or role
transitionPOST /v1/{plural}/{id}/transitionThe move is not listed. If the target state is gated, the result is 202 and an Approval, not the new state
deleteDELETE /v1/{plural}/{id}?reason=The resource is not deletable, is frozen, or the reason is missing

Named operations

Some behavior is not a fifth CRUD verb. Each resource page lists its named operations. The ones that apply across the server:

Search is the list filters above. This standard does not define a general search language. A code in an observation is filtered by reading observations for the patient, not by a search parameter grammar.