---
title: "Delete integration registration and remove connection account"
method: DELETE
path: "/api/integrations/instances/{instance_id}"
tags: ["integrations"]
---

# Delete integration registration and remove connection account

`DELETE /api/integrations/instances/{instance_id}`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/integrations/instances/{instance_id}`
- Auth: none declared

Delete one integration registration (connection account) and its logins.

Requires admin authority over the connection's folder. Deletes the selected
registration, rather than only uninstalling a user's or agent's holding.
Sibling connections remain. The connector definition is retained while other
connections or a live publication use it.

Refused with a 409 while a development repository binding still points at it.
The database keeps that link on purpose (``ON DELETE RESTRICT``): removing a
binding would also remove its task checkpoints, so deleting the connection must
not do it silently. Before this check the delete reached the database and came
back as an unhandled ForeignKeyViolation, a 500 with no explanation
(THINQOS-BACKEND-10M).

## Path parameters

- `instance_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

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