Delete Integration Connection: /integration/{connection-uuid}
Purpose
This API endpoint deletes an existing integration connection identified by its unique UUID. It permanently removes the connection and any associated data sync configurations from the platform. This operation is used to revoke access and stop all data flows between the platform and the connected external system.
Use Case
This endpoint is typically used by integration administrators or developers who need to remove outdated, unused, or compromised integration connections. For example, when a tenant disconnects from an accounting system or when cleaning up obsolete integrations. If the connection UUID is invalid or the caller lacks sufficient permissions, the API returns an error response with detailed messages to aid in troubleshooting.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| connection_uuid | String | Unique identifier of the integration connection to be deleted |
Query Parameters
No query parameters are required for this endpoint.
Request Body
No request body is required for this endpoint.
Response
This endpoint does not return a response body. Upon successful execution, the integration connection is deleted and an HTTP 204 No Content status code is returned. If the deletion fails due to issues such as an invalid connection UUID or insufficient permissions, the API returns an error response with descriptive messages and backend details to assist with troubleshooting and resolution.