---
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}`

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

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/versions/e6e553c2594a/schema)