This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
Definition for Code System FHIR Restful Interactions
<CodeSystem xmlns="http://hl7.org/fhir"> <id value="restful-interaction"/> <meta> <lastUpdated value="2016-12-06T12:22:34.981+11:00"/> </meta> <text> <status value="generated"/> <div xmlns="http://www.w3.org/1999/xhtml"> <h2>FHIR Restful Interactions</h2> <div> <p>The set of interactions defined by the RESTful part of the FHIR specification.</p> </div> <p>This code system http://hl7.org/fhir/restful-interaction defines the following codes:</p> <table class="codes"> <tr> <td> <b>Lvl</b> </td> <td> <b>Code</b> </td> <td> <b>Display</b> </td> <td> <b>Definition</b> </td> </tr> <tr> <td>1</td> <td>read <a name="restful-interaction-read"> </a> </td> <td>read</td> <td>Read the current state of the resource.</td> </tr> <tr> <td>1</td> <td>vread <a name="restful-interaction-vread"> </a> </td> <td>vread</td> <td>Read the state of a specific version of the resource.</td> </tr> <tr> <td>1</td> <td>update <a name="restful-interaction-update"> </a> </td> <td>update</td> <td>Update an existing resource by its id (or create it if it is new).</td> </tr> <tr> <td>1</td> <td>patch <a name="restful-interaction-patch"> </a> </td> <td>patch</td> <td>Update an existing resource by posting a set of changes to it.</td> </tr> <tr> <td>1</td> <td>delete <a name="restful-interaction-delete"> </a> </td> <td>delete</td> <td>Delete a resource.</td> </tr> <tr> <td>1</td> <td>history <a name="restful-interaction-history"> </a> </td> <td>history</td> <td>Retrieve the change history for a particular resource, type of resource, or the entire system.</td> </tr> <tr> <td>2</td> <td> history-instance <a name="restful-interaction-history-instance"> </a> </td> <td>history-instance</td> <td>Retrieve the change history for a particular resource.</td> </tr> <tr> <td>2</td> <td> history-type <a name="restful-interaction-history-type"> </a> </td> <td>history-type</td> <td>Retrieve the change history for all resources of a particular type.</td> </tr> <tr> <td>2</td> <td> history-system <a name="restful-interaction-history-system"> </a> </td> <td>history-system</td> <td>Retrieve the change history for all resources on a system.</td> </tr> <tr> <td>1</td> <td>create <a name="restful-interaction-create"> </a> </td> <td>create</td> <td>Create a new resource with a server assigned id.</td> </tr> <tr> <td>1</td> <td>search <a name="restful-interaction-search"> </a> </td> <td>search</td> <td>Search a resource type or all resources based on some filter criteria.</td> </tr> <tr> <td>2</td> <td> search-type <a name="restful-interaction-search-type"> </a> </td> <td>search-type</td> <td>Search all resources of the specified type based on some filter criteria.</td> </tr> <tr> <td>2</td> <td> search-system <a name="restful-interaction-search-system"> </a> </td> <td>search-system</td> <td>Search all resources based on some filter criteria.</td> </tr> <tr> <td>1</td> <td>capabilities <a name="restful-interaction-capabilities"> </a> </td> <td>capabilities</td> <td>Get a Capability Statement for the system.</td> </tr> <tr> <td>1</td> <td>transaction <a name="restful-interaction-transaction"> </a> </td> <td>transaction</td> <td>Update, create or delete a set of resources as a single transaction.</td> </tr> <tr> <td>1</td> <td>batch <a name="restful-interaction-batch"> </a> </td> <td>batch</td> <td>perform a set of a separate interactions in a single http operation</td> </tr> <tr> <td>1</td> <td>operation <a name="restful-interaction-operation"> </a> </td> <td>operation</td> <td>Perform an operation as defined by an OperationDefinition.</td> </tr> </table> </div> </text> <url value="http://hl7.org/fhir/restful-interaction"/> <name value="FHIR Restful Interactions"/> <status value="draft"/> <publisher value="FHIR Project"/> <description value="The set of interactions defined by the RESTful part of the FHIR specification."/> <caseSensitive value="true"/> <valueSet value="http://hl7.org/fhir/ValueSet/restful-interaction"/> <hierarchyMeaning value="is-a"/> <content value="complete"/> <concept> <code value="read"/> <display value="read"/> <definition value="Read the current state of the resource."/> </concept> <concept> <code value="vread"/> <display value="vread"/> <definition value="Read the state of a specific version of the resource."/> </concept> <concept> <code value="update"/> <display value="update"/> <definition value="Update an existing resource by its id (or create it if it is new)."/> </concept> <concept> <code value="patch"/> <display value="patch"/> <definition value="Update an existing resource by posting a set of changes to it."/> </concept> <concept> <code value="delete"/> <display value="delete"/> <definition value="Delete a resource."/> </concept> <concept> <code value="history"/> <display value="history"/> <definition value="Retrieve the change history for a particular resource, type of resource, or the entire system."/> <concept> <code value="history-instance"/> <display value="history-instance"/> <definition value="Retrieve the change history for a particular resource."/> </concept> <concept> <code value="history-type"/> <display value="history-type"/> <definition value="Retrieve the change history for all resources of a particular type."/> </concept> <concept> <code value="history-system"/> <display value="history-system"/> <definition value="Retrieve the change history for all resources on a system."/> </concept> </concept> <concept> <code value="create"/> <display value="create"/> <definition value="Create a new resource with a server assigned id."/> </concept> <concept> <code value="search"/> <display value="search"/> <definition value="Search a resource type or all resources based on some filter criteria."/> <concept> <code value="search-type"/> <display value="search-type"/> <definition value="Search all resources of the specified type based on some filter criteria."/> </concept> <concept> <code value="search-system"/> <display value="search-system"/> <definition value="Search all resources based on some filter criteria."/> </concept> </concept> <concept> <code value="capabilities"/> <display value="capabilities"/> <definition value="Get a Capability Statement for the system."/> </concept> <concept> <code value="transaction"/> <display value="transaction"/> <definition value="Update, create or delete a set of resources as a single transaction."/> </concept> <concept> <code value="batch"/> <display value="batch"/> <definition value="perform a set of a separate interactions in a single http operation"/> </concept> <concept> <code value="operation"/> <display value="operation"/> <definition value="Perform an operation as defined by an OperationDefinition."/> </concept> </CodeSystem>
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.