Delete
[POST] .../v1/integration/delete
Deletes local integration. Use this destructive method to permanently delete an account-local integration after it is no longer used by external workflows. The method validates the local integration by key, rejects public integrations, sends a disconnect notification to the adapter, deletes the integration in the external REGOS integration registry, removes the connected integration row, deletes the related access token and publishes an internal notification. The request body is required and key must identify exactly one local integration; key is limited to 150 characters. The current request user must have permission to manage local integrations; if the integration belongs to another user, the persistent layer also requires permission to manage other users' local integrations. Missing body, missing key, denied access, disabled API-access tariff option, integration not found, multiple matches, attempts to delete a public integration, external registry failures, transaction failures and database errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| key | String | Required | Integration key, which is the system name. |
Request Example
{
"key": "2e7d7aeb2a0c449b80dfd8df7f092921"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
Response Example
{
"ok": true,
"result": null
}