Disconnect
[POST] .../v1/connectedintegration/disconnect
Disconnects an integration. Remove a replicated connected integration from the account when the integration should no longer be used by REGOS. The method clears REGOS references that point to the connected integration, notifies the external integration service, disconnects the external token and returns a standard OkResult with no payload on success. The request body is required and must provide connected_integration_id. The current request user must have permission to manage other users' public integrations; missing body, missing identifier, unresolved integration, external disconnect failure, notification failure and storage errors are returned as HTTP 200 ErrorResult. The typical workflow is ConnectedIntegration/Get, then ConnectedIntegration/Disconnect for the selected connected_integration_id.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| connected_integration_id | String | Optional | Connected integration ID. Takes priority over key when both fields are passed. |
Request Example
{
"connected_integration_id": "c98210addc4f4e1bb50b17a8c1299a37"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
Response Example
{
"ok": true,
"result": null
}