PATIENT_ID_REQUIRED

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

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

What this means

A practitioner shared a record with a related person but did not say whose record it is. POST /v1/invites/record-share with recipient: "related-person" needs patientId when the caller is a practitioner. Nothing was written and no email went out.

Troubleshooting

  1. Send the id of the patient whose readings the related person should see, as patientId.
  2. Check that you may update that patient under your access policy. A patient you cannot read is refused with 404, and one you may only read with 403.

Retry safely

Retry the same request with patientId set. Nothing was created, so the retry cannot send a second invite.

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