PATIENT_REF_REQUIRED

Patient reference required: what the PATIENT_REF_REQUIRED error means and how to fix it.

HTTP 422. Problem type: https://docs.ovok.com/errors/patient-ref-required.

What this means

A reading did not name its patient, so Signals stored nothing. A reading names its patient by patientRefId, or by subject.reference in the form Patient/<refId>.

Troubleshooting

  1. Add patientRefId with the patient's refId, or subject.reference as Patient/<refId>.
  2. Check that subject.reference ends with Patient/ and the refId. Other forms are not read.

Retry safely

Name the patient and send the reading once. Unchanged, it fails again. Nothing was stored.

If the problem persists

Share the HTTP status, problem type, request path, response timestamp and traceId with your administrator or support contact. Remove access tokens, provider secrets and patient data first. The Error responses guide explains the response fields, and the machine-code registry lists every endpoint-specific type.

Last updated on

On this page