---
title: "Replay HL7 Message"
method: POST
path: "/v1/hl7/replay/{logId}"
tags: ["HL7"]
---

# Replay HL7 Message

`POST /v1/hl7/replay/{logId}`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/hl7/replay/{logId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/hl7/replay/:logId/post.ts> (a function with typed inputs; its response is checked against the schema)

Replay a previously sent outbound HL7 message by its log ID. The exact same message will be re-sent to the specified destination. If no destination is provided, the original destination will be used (credentials required).

## Path parameters

- `logId` string, required

## Request body

- object
  - `destination` object: Destination configuration for sending the message. If not provided, uses the original destination from the log.
    - `url` string: Hostname (with optional path) or full URL for the HL7 endpoint (e.g. https://emr.example.com/webchart.cgi)
    - `protocol` 'http' | 'https': Transport protocol (default: https)
    - `port` number: Explicit port override
    - `username` string: Basic/form auth username
    - `password` string: Basic/form auth password
    - `timeout` number: Request timeout in ms (default: 30000)
    - `retryAttempts` number: Max retry attempts (default: 3)
    - `retryDelay` number: Base retry delay in seconds (default: 1)
  - `interfaceName` string: Interface name to use in the request (default: bluehiveadt)

## Response `200`

Result of the replayed HL7 message send

- object: Result of the replayed HL7 message send
  - `success` boolean
  - `messageId` string
  - `acknowledgment` string
  - `retryCount` number
  - `duration` number
  - `originalLogId` string
  - `newLogTimestamp` string

## Other responses

- `400`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-03-02** `8c1496e8c14a`: 1 breaking
  - the `destination/url` request property's minLength was increased from `0` to `4`
- **2026-01-22** `8c6cc29fec5b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/hl7/replay/:logId/post.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)