---
title: "Disconnect Entity"
method: POST
path: "/disconnect-entity"
tags: ["Management"]
---

# Disconnect Entity

`POST /disconnect-entity`

Disconnect entity(s) from a connection without affecting other entities associated with the same connection.

## Headers

- `Finch-API-Version` string, date, required

## Request body

- DisconnectEntityRequest
  - `entity_ids` string[], required — Array of entity UUIDs to disconnect. At least one entity ID must be provided.

## Response `200`

OK

- DisconnectEntityResponse
  - `status` string, required — If the request is successful, Finch will return "success" (HTTP 200 status).

## Other responses

- `400` — Bad request. Either the request body is malformed (missing or invalid entity_ids) or one or more entity IDs failed validation.

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)