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

  1. Look up which patient holds the refId with the patient IDs list.
  2. Update that patient instead if it is the same person.
  3. Otherwise give this patient a refId of 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

On this page