Update a Resource

See the FHIR documentation for more information.

Concurrency

To avoid overwriting data, an application must always indicate which version of a Resource the update is based on. This is done using the If-Match header. If this header is missing, the Koppeltaal server will reject the request. If the update is not based on the latest version, the server will respond with a 409 Conflict or a 412 Precondition Failed.

The If-Match value must match the latest ETag value. The ETag value is provided via a response header sent by the Koppeltaal server after a Create, Update or Get.

Update a complete resource

PUT https://fhir-server.koppeltaal.headease.nl/fhir/DEFAULT/<Resource>/<:id>

Note: the

id

property has to be set in the body as well

Path Parameters

Name	Type	Description
id*	string	The "logical id" of the Resource

Headers

Name	Type	Description
If-Match*	string	A "weak" ETag to the version the update is based on, e.g: W/"3"
Authorization*	string	Bearer token obtained from the Auth Server \ (see Connecting to Koppeltaal )

Request Body

Name	Type	Description
*	string	The Resource

200 Resource is modified. The resource with resource-origin extension and logical id is returned

400 The resource cannot be parsed or does not conform to the basic FHIR validation rules

404 Resource type not supported, or not a FHIR end-point

405 The Resource did not exist prior to the update, and the server does not allow client defined ids

409 Version conflict, update is based on an old version

412: Precondition Failed Version conflict, update is based on an old version

{
    // Response
}

422 Does not meet FHIR profiles or Koppeltaal business rules

Delen van een Resource Updaten

PATCH requests are optional. See the Conformance to find out if the server supports this.

To update a Resource via a small payload, the Koppeltaal server may support PATCH requests. The payload of the PATCH must be one of the following:

1. A JSON Patch (Content-Type application/json-patch+json).

2. An XML Patch (Content-Type application/xml-patch+xml)

3. A FHIRPath Patch parameters Resource (Content-Type FHIR Content Type).

This is what the payload looks like from a JSON Patch to update the status of a Task

[{
    "op": "replace",
    "path": "/status",
    "value": "completed"
}]

More examples of patches can be downloaded here.

Patch a Resource

PATCH https://hapi-fhir-server.koppeltaal.headease.nl/fhir/<Resource>/<:id>

As an alternative to updating an entire resource, clients can perform a patch operation. This can be useful when a client is seeking to minimize its bandwidth utilization.

Path Parameters

Name	Type	Description
*	String	The "logical id" of the Resource

Headers

Name	Type	Description
If-Match*	string	A "weak" ETag to the version the update is based on, e.g: W/"3"
Authorization*	string	Bearer token obtained from the Auth Server \ (see Connecting to Koppeltaal )

Request Body

Name	Type	Description
*	object	The Patch

200 Patch is applied. The complete Resource will be returned

404: Not Found Resource type not supported, or not a FHIR end-point

{
    // Response
}

405: Method Not Allowed

{
    // Response
}

412: Precondition Failed Version conflict, update is based on an old version

{
    // Response
}

Topics

TOP-KT-002a - FHIR Resource Service interacties

TOP-KT-005a - Rollen en rechten voor applicatie-instanties

TOP-KT-009 - Overzicht gebruikte FHIR Resources