HL7_ROUTE_INVALID

HL7 connection incomplete: what the HL7_ROUTE_INVALID error means and how to fix it.

HTTP 422. Problem type: https://docs.ovok.com/errors/hl7-route-invalid.

What this means

The HL7 connection is incomplete: its agent or its destination is gone, belongs to another project, or the destination has no address. Readings for it cannot be sent. You see this in the connection's delivery log, not in a user request.

Troubleshooting

  1. Open the connection with GET /v1/hl7-connections/<id> and check that it shows an agent and a destination.
  2. Remove the connection and make it again. Connections are made whole, so a new one has every part it needs.
  3. Install the new agent credentials on the hospital's host, since the removed connection's credentials stop working.

Retry safely

Retrying does not help: every delivery for the connection fails the same way until you make it again. A new connection does not resend the readings that failed, so resend the ones you need once its agent is connected.

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