"The field 'relatesTo' is immutable and cannot be updated" error

National Record Locator (NRL) FAQ-Troubleshooting
,
1

I am having issues with Update (PUT) document reference.

If I do not populate the relatesTo field, it complains:

"diagnostics": "The field 'relatesTo' is immutable and cannot be updated",
"expression": 	[
                	"relatesTo"
	            ]

The original ‘create’ did not contain a relatesTo, but after superseding, it was added.

{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "required",
"details": {
"coding": [
{
"system": "https://fhir.nhs.uk/CodeSystem/Spine-ErrorOrWarningCode",
"code": "PRECONDITION_FAILED",
"display": "Precondition failed"
}
]
},
"diagnostics": "The 'nrl-app-id' custom attribute for your application is missing or invalid. Please contact onboarding team to resolve the issue."
}
]
}

2

When trying to update a pointer, the content in the ‘relatedTo’ field has to match what this field was previously populated with. This cannot be changed. So, your update request should also contain the same ‘relatesTo’ that you used in the supersede.