Update an allergy intolerance
put
/AllergyIntolerance/{ID}
Updates an allergy intolerance.
Note:
- Missing fields are interpreted as nulling out or removing data from the resource. See FHIR Update for additional details about update operations.
note
cannot be added ifnote
already exists. An existingnote
field cannot be modified.
Authorization Types
This operation supports the following authorization types:
- Provider
- System
Request
Supported Media Types
- application/fhir+json
Path Parameters
-
ID(required): string
The logical resource ID associated with the resource.
Header Parameters
-
Accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
-
If-Match(required): string
The current version of the AllergyIntolerance resource.
The body of the update operation.
Root Schema : AllergyIntoleranceUpdate
Type:
Show Source
object
-
category(required):
string
The category of the identified substance.
Example:{ "type": "food" }
-
contained:
string
Contained, inline resources.
Note: These resources should bePractitioner
orRelatedPerson
resources that are referenced with the reporter field.
Example:
Contained RelatedPerson{ "contained": [ { "resourceType": "RelatedPerson", "id": "5366328", "relationship": { "coding": [ { "system": "http://hl7.org/fhir/v3/RoleCode", "code": "SIGOTHR" } ] } } ] }
Contained Practitioner{ "contained": [ { "resourceType": "Practitioner", "id": "123", "practitionerRole": [ { "role": { "coding": [ { "system": "http://hl7.org/fhir/v2/0286", "code": "RP" } ] } } ] } ] }
-
criticality(required):
string
The estimate of the potential clinical harm, or seriousness, of the reaction to the identified substance.
Example:{ "criticality": "CRITU" }
-
id(required):
string
The logical ID of the resource to update.
Note: The ID value must match the AllergyIntolerance value.
Example:{ "id": "123412" }
-
note:
object note
Additional text not captured in other fields.
Example:{ "note": { "authorReference": { "reference": "Practitioner/21500971" }, "time": "2015-10-14T13:13:20-06:00", "text": "Patient complains of discomfort" } }
-
note.authorReference:
object note.authorReference
The individual responsible for the annotation.
Example:{ "note": { "authorReference": { "reference": "Practitioner/21500971" } } }
-
note.text(required):
string
The text content.
Example:{ "note": { "text": "Patient complains of discomfort" } }
-
note.time:
string
When the annotation was made.
Example:{ "note": { "time": "2015-10-14T13:13:20-06:00" } }
-
onset:
string
The date, time, or both when manifestations showed.
Example:{ "onset: "2012-07-13T00:00:00Z" }
-
patient(required):
object patient
Who the sensitivity is for.
Example:{ "patient": { "reference": "Patient/5366327" } }
-
reaction:
array reaction
The adverse reaction events linked to exposure to the substance.
Example:{ "reaction": [ { "manifestation": [ { "coding": [ { "system": "http://snomed.info/sct", "code": "39579001", "display": "Anaphylactic reaction" } ] } ] } ] }
-
recordedDate(required):
string
When the sensitivity was recorded.
Example:{ "recordedDate": "2015-10-14T13:13:20-06:00" }
-
recorder:
object recorder
Who recorded the sensitivity.
Note: The recorder must be aPractitioner
reference.
Example:{ "recorder": { "reference": "Practitioner/21500971" } }
-
reporter(required):
The source of the information about the allergy.
Note: If the reporter is a contained reference, a matchingRelatedPerson
orPractitioner
reference must be provided in thecontained
field.
Example:
Reporter as a Patient Reference{ "reporter": { "reference": "Patient/5366327" } }
Reporter as a contained reference{ "reporter": "#5366328" }
-
resourceType(required):
string
Allowed Values:
[ "AllergyIntolerance" ]
The type of the FHIR resource. -
status(required):
string
The assertion about the certainty associated with the propensity, or potential risk, of a reaction to the identified substance.
Example:{ "status": "resolved" }
-
substance(required):
object substance
The substance (or class) that is considered responsible for risk.
Example:{ "substance": { "coding": [ { "system": "http://www.nlm.nih.gov/research/umls/rxnorm", "code": "4125", "display": "Ethiodized oil" } ] } }
-
type:
string
The identification of the underlying physiological mechanism for the reaction risk.
Example:{ "type": "allergy" }
Nested Schema : note
Type:
object
Additional text not captured in other fields.
Example:
Show Source
Example:
{
"note": {
"authorReference": {
"reference": "Practitioner/21500971"
},
"time": "2015-10-14T13:13:20-06:00",
"text": "Patient complains of discomfort"
}
}
Nested Schema : patient
Type:
object
Who the sensitivity is for.
Example:
Show Source
Example:
{
"patient": {
"reference": "Patient/5366327"
}
}
Nested Schema : reaction
Type:
array
The adverse reaction events linked to exposure to the substance.
Example:
Show Source
Example:
{
"reaction": [
{
"manifestation": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39579001",
"display": "Anaphylactic reaction"
}
]
}
]
}
]
}
Nested Schema : recorder
Type:
object
Who recorded the sensitivity.
Note: The recorder must be a
Example:
Show Source
Note: The recorder must be a
Practitioner
reference.
Example:
{
"recorder": {
"reference": "Practitioner/21500971"
}
}
Nested Schema : substance
Type:
object
The substance (or class) that is considered responsible for risk.
Example:
Show Source
Example:
{
"substance": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "4125",
"display": "Ethiodized oil"
}
]
}
}
Nested Schema : items
Type:
Show Source
object
-
reaction.id:
string
The logical ID of the reaction event.
Example:{ "id": "543123" }
-
reaction.manifestation:
array reaction.manifestation
The clinical symptoms or signs associated with the event.
Example:
Manifestation with a coding:{ "reaction": [ { "manifestation": [ { "coding": [ { "system": "http://snomed.info/sct", "code": "39579001", "display": "Anaphylactic reaction" } ] } ] } ] }
Manifestation with a free-text value:{ "reaction": [ { "manifestation": [ { "text": "Anaphylactic reaction" } ] } ] }
Nested Schema : reaction.manifestation
Type:
array
The clinical symptoms or signs associated with the event.
Example:
Manifestation with a coding:
Manifestation with a free-text value:
Show Source
Example:
Manifestation with a coding:
{
"reaction": [
{
"manifestation": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39579001",
"display": "Anaphylactic reaction"
}
]
}
]
}
]
}
Manifestation with a free-text value:
{
"reaction": [
{
"manifestation": [
{
"text": "Anaphylactic reaction"
}
]
}
]
}
Response
Supported Media Types
- application/fhir+json
Default Response
Example Request:
PUT https://fhir-ehr-code.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/AllergyIntolerance/12760025
Example Request Body:
{
'resourceType': 'AllergyIntolerance',
'id': '12760025',
'meta': {
'versionId': '12760025',
'lastUpdated': '2020-03-04T20:16:02.000Z'
},
'contained': [
{
'resourceType': 'Practitioner',
'id': '638994',
'practitionerRole': [
{
'role': {
'coding': [
{
'system': 'http://hl7.org/fhir/practitioner-role',
'code': 'doctor',
'display': 'Doctor'
}
],
'text': 'Doctor'
}
}
]
}
],
'onset': '2020-2',
'recordedDate': '2020-05-04T14:16:02.000-06:00',
'patient': {
'reference': 'Patient/12742399'
},
'substance': {
'coding': [
{
'system': 'http://snomed.info/sct',
'code': '102263004',
'display': 'Eggs (edible) (substance)',
'userSelected': false
}
],
'text': 'Egg'
},
'status': 'active',
'criticality': 'CRITH',
'category': 'food',
'reaction': [
{
'id': '3363737',
'manifestation': [
{
'coding': [
{
'system': 'http://snomed.info/sct',
'code': '79962008',
'display': 'Diffuse spasm of esophagus (disorder)',
'userSelected': false
}
],
'text': 'Barsony-Teschendorf syndrome'
}
]
}
]
}
Example Response:
HTTP Status: 200 OK
Date: Tue, 28 Feb 2017 21:19:18 GMT
Cache-Control: no-cache
Vary: Origin,User-Agent,Accept-Encoding
Strict-Transport-Security: max-age=631152000
X-Xss-Protection: 1; mode=block
Pragma: no-cache
X-Request-Id: 11111111111111111111111111111111
Etag: W/"6167741"
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Last-Modified: Tue, 28 Feb 2017 21:03:00 GMT
Content-Length: 0
Content-Type: application/json
Headers
-
Etag: string
For Update or Patch versioning controls. Related to
If-Match
. When a resource performs an operation that creates or updates a record, anEtag
value is returned as a header. This same value should be included in request headers as anIf-Match
for any subsequent update to that record. -
If-Match: string
For Update or Patch versioning controls. Related to
Etag
. When a resource performs an operation that creates or updates a record, anEtag
value is returned as a header. This same value should be included in request headers as anIf-Match
for any subsequent update to that record. -
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.