Modify a No Known Allergy (NKA) record
/20240101/actions/modifyNoKnownAllergy
Modifies a No Known Allergy (NKA) record from the given patient ID and allergy ID.
Matches the value of the If-Match Request Header against the ETag from the GET allergy/{allergyId}
request.
Request
-
patientId(required): string
Identifier of patient to filter the resource query against.
-
accept: string
Specifies which media types are acceptable for the response. Defaults to
application/json
.Default Value:application/json
-
accept-charset: string
Specifies which character sets are acceptable for the response. Defaults to
UTF-8
.Default Value:UTF-8
-
authorization(required): string
Contains the credentials to authenticate a consumer to the service.
-
if-match: string
For optimistic concurrency control. In the
PUT
orDELETE
request for a resource, set theif-match
parameter to the value of the etag from a previousGET
orPOST
response for that resource. The resource is updated or deleted only if the etag you provide matches the resource's current etag value. -
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
-
opc-retry-token: string
Minimum Length:
1
Maximum Length:64
A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of running that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and removed from the system, then a retry of the original creation request might be rejected.
object
-
object
ModifyNoKnownAllergy
The No Known Allergy (NKA) and No Known Medication Allergy (NKMA) to be modified.
object
-
cancelReasonId:
object CodeValueId
The unique identifier of a code value.
-
encounterId:
string
The encounter that the No Known Allergy (NKA) and No Known Medication Allergy (NKMA) record is associated with.
-
id(required):
string
The unique identifier of the No Known Allergy (NKA) and No Known Medication Allergy (NKMA) record.
-
status(required):
string
Allowed Values:
[ "ACTIVE", "CANCELED" ]
The status to which record needs to be modified.
Response
- application/json
200 Response
-
etag: string
For optimistic concurrency control. See
if-match
. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
object
-
cancelReason:
object CodeValueSimple
A minimal representation of a code value.
-
category:
object CodeValueSimple
A minimal representation of a code value.
-
createdBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
createdDateTime(required):
string(date-time)
The date and time that the allergy was created in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
criticality:
object CodeValueSimple
A minimal representation of a code value.
-
encounterId:
string
The unique identifier of the encounter that the allergy was added to.
If no encounter is associated with the allergy, then this value is omitted.
-
id(required):
string
The unique identifier of the allergy.
-
infoSource:
object CodeValueSimple
A minimal representation of a code value.
-
isPharmacyVerified:
boolean
Default Value:
false
The indicator that denotes if the allergy is verified by a pharmacy. -
lastModifiedBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
lastModifiedDateTime(required):
string(date-time)
The date and time that the allergy was last modified in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
notes:
array notes
Unique Items Required:
true
The list of notes added to this allergy. This value can be empty. -
onBehalfOf:
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
onset:
object AllergyFuzzyDateTime
The model object for a fuzzy date associated with a clinical concept with a corresponding precision and unit applied to it.
The precision and unit are used in conjunction with the provided date and time to communicate a possibly imprecise date, for example, Age 28 or Sometime After 2020-04. Note that the
/referenceData
for a given API should be queried to confirm exactly whichFuzzyDateTimeUnit
orFuzzyDateTimePrecision
values are supported by that API. -
organizationId:
string
The unique identifier of the organization.
-
patient(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
permissions:
array permissions
Unique Items Required:
true
The set of allergy related permissions granted to the requesting user.
MODIFY_ALLERGY
indicates that the user has permission to modify the existing allergy. -
reactions:
array reactions
Unique Items Required:
true
A list of reactions associated with this allergy. This list can be empty. -
reactionType:
object CodeValueSimple
A minimal representation of a code value.
-
reviewInfo:
object ReviewInfo
The information around who and when the data was reviewed.
-
status:
object AllergyStatus
The allergy status details.
-
substance(required):
object NomenclatureOrFreetextValue
The nomenclature or free text value of the data.
-
version(required):
string
The unique identifier of this version of the allergy.
object
-
cdfMeaning:
string
A programmatic value, primarily used by applications to search for this value.
-
display:
string
The text consumers see that represents this code value.
-
id(required):
string
The ID of the code value.
object
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
id(required):
string
The unique identifier for the individual.
-
name:
object PersonNameSummary
A summary of the first, last, and full name for a person. The person could be a personnel member, patient, or non-patient person.
array
true
-
Array of:
object Annotation
A text note that also contains information about who made the statement and when.
object
The model object for a fuzzy date associated with a clinical concept with a corresponding precision and unit applied to it.
The precision and unit are used in conjunction with the provided date and time to communicate a possibly imprecise date, for example,
Age 28 or Sometime After 2020-04. Note that the /referenceData
for a given API should be queried to confirm exactly which
FuzzyDateTimeUnit
or FuzzyDateTimePrecision
values are supported by that API.
-
dateTime:
object DateTimeStringWithZone
Representation of the date and time with time zone.
-
precision:
object AllergyFuzzyDateTimePrecision
A code value representation of the precision associated with a date.
-
unit:
object AllergyFuzzyDateTimeUnit
A display and enumerated meaning structure representing the date and time unit like
DAY
,WEEK
,MONTH
, andYEAR
.
array
true
The set of allergy related permissions granted to the requesting user.
MODIFY_ALLERGY
indicates that the user has permission to modify the existing allergy.
-
Array of:
string
Allowed Values:
[ "MODIFY_ALLERGY" ]
array
true
-
Array of:
object AllergyReaction
The allergy reaction details.
object
-
reviewedBy(required):
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
reviewedDateTime(required):
object DateTimeWithZone
Representation of date and time with the time zone.
object
-
lastModifiedDateTime:
string(date-time)
The date and time when the status was last updated in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
value:
object CodeValueSimple
A minimal representation of a code value.
object
-
freeText:
string
The free text display of the data. This display is returned only if the type is
FREE_TEXT
. -
nomenclature:
object NomenclatureSimple
The model object for a nomenclature.
-
type(required):
string
Allowed Values:
[ "NOMENCLATURE", "FREE_TEXT" ]
The type of value the data is captured as.
object
-
firstName:
string
The person's first given name.
-
fullName:
string
The fully formatted name.
-
lastName:
string
The person's family last name.
object
-
author:
object PersonSimple
A simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a non-patient person.
-
dateTime:
string(date-time)
The date and time represented in the format (YYYY-MM-DDTHH:MM:SS:SSSZ) without the UTC offset as defined by RFC 3339. No time zone information is associated with this date and time.
-
text:
string
The annotation text
object
-
dateTime:
string
The date and time represented in YYYY-MM-DDTHH:MM:SS:SSSZ format without the UTC offset as defined by RFC 3339.
No timezone information is associated with this date and time. -
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTime
contains time, then this value is required.
object
-
display(required):
string
The display for the code value.Example:
Display
-
id(required):
string
The ID of the code value.Example:
1643574645
-
meaning:
string
Allowed Values:
[ "ABOUT", "AFTER", "AGE", "BEFORE", "UNKNOWN" ]
The enumerated meaning of the code value. Should almost always be populated, but caution should be taken when consuming this enum in case it is not populated or has a value other than those listed.
object
DAY
, WEEK
, MONTH
, and YEAR
.-
display(required):
string
The display for the date and time unit.Example:
Date
-
meaning:
string
Allowed Values:
[ "TIME", "DAY", "WEEK", "MONTH", "YEAR" ]
The unit associated with the fuzzy date.Example:DAY
object
-
id:
string
The unique identifier of the reaction.
-
isActive:
boolean
Default Value:
false
The status of the reaction. Returns true if the reaction is active. The default is false. -
lastModifiedDateTime:
string(date-time)
The date and time that the reaction was updated in the ISO-8601 representation of the date and time format (YYYY-MM-DDTHH:MM:SS:SSSZ) as defined by RFC 3339.Example:
2018-06-16T21:31:35.457Z
-
severity:
object CodeValueSimple
A minimal representation of a code value.
-
symptom(required):
object NomenclatureOrFreetextValue
The nomenclature or free text value of the data.
object
-
dateTime:
string(date-time)
The date and time represented in YYYY-MM-DDTHH:MM:SS:SSSZ format without the UTC offset as defined by RFC 3339.
No time zone information is associated with this date and time.
-
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTime
contains time, this value is required.
object
-
code:
string
The universal clinical code of the term.Example:
452.5b
-
conceptCki:
string
The concept CKI of the nomenclature.
-
displayName:
string
The display of the nomenclature.Example:
Anemia Nomenclature
-
id(required):
string
The unique identifier of the nomenclature.Example:
1643574645
-
terminology:
object CodeValueSimple
A minimal representation of a code value.
-
terminologyAxis:
object CodeValueSimple
A minimal representation of a code value.
400 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
401 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
403 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
404 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
409 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
412 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
422 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
429 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.
500 Response
-
opc-request-id: string
Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
object
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any errors from the resulting service call.
-
message(required):
string
A human-readable error message.
array
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
object
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
object
-
headers:
array headers
A list of the request headers which caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
/data
for a primary data object, or/data/attributes/title
for a specific attribute. A JSON pointer must point to a value in the request document that exists; if it does not, ignore the pointer.
array
array
array
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example, /data
for a primary data object, or /data/attributes/title
for a specific attribute. A JSON pointer must
point to a value in the request document that exists; if it does not, ignore the pointer.