REF_ID_TAKEN
Patient refId taken: what the REF_ID_TAKEN error means and how to fix it.
HTTP 409. Problem type: https://docs.ovok.com/errors/ref-id-taken.
What this means
Another patient in the tenant already has that refId, so Signals saved nothing. A refId is unique within a tenant.
Troubleshooting
- Look up which patient holds the
refIdwith the patient IDs list. - Update that patient instead if it is the same person.
- Otherwise give this patient a
refIdof its own.
Retry safely
An unchanged request returns the same error. Nothing was saved, so a request with another refId starts clean.
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