---
title: "Remove HL7 System Interface"
method: DELETE
path: "/v1/hl7-systems/{id}/interfaces/{interfaceId}"
tags: ["HL7 Systems"]
---

# Remove HL7 System Interface

`DELETE /v1/hl7-systems/{id}/interfaces/{interfaceId}`

## Request

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

Remove an outbound interface from an HL7 system.

## Path parameters

- `id` string, required
- `interfaceId` string, required

## Response `200`

Default Response

- object
  - `_id` string, required
  - `sendingApplication` string, required
  - `sendingFacility` string, required
  - `receivingApplication` string, required
  - `receivingFacility` string, required
  - `systemKey` string, required
  - `name` string, required
  - `status` 'unmapped' | 'active' | 'disabled', required
  - `interfaces` object[]
    - `id` string, required
    - `name` string, required
    - `messageTypes` string[], required
    - `url` string, required
    - `method` 'POST' | 'PUT'
    - `headers` object
    - `username` string
    - `password` string
    - `interfaceName` string
    - `enabled` boolean, required
  - `brandId` string
  - `autoRegistered` boolean
  - `firstSeenAt` string, date-time
  - `lastSeenAt` string, date-time
  - `messageCount` integer
  - `lastMessageType` string
  - `notes` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-02-18** `efcb45ec0e67`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/hl7-systems/:id/interfaces/:interfaceId/delete.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)