---
title: "Forcefully disables one or more Controller functions."
slug: "forcefully-disables-one-or-more-controller-functions-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/forcefully-disables-one-or-more-controller-functions-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forcefully disables one or more Controller functions.

Post/appliances/force-disable-controllers

This API is supposed to be used when one or more Controller functions cannot be removed either because the Appliances are unresponsive or database status is not fixable. Use of the API by itself is not recommended. Use sdpctl instead.

SecurityHTTPType bearer

Body parameters

Active Appliances to disable the Controller function for.

<select class='api-response-data' aria-label='Media type'><option value='fff4c943-2051-4ca7-b798-c809262d4626'>application/json</option>
</select>object  applianceIds Array of string   Required

IDs of the Controller Appliance's to disable the function for.

string  (uuid)    

Responses200

Controller functions were disabled for the given Appliance list successfully.

<select class='api-response-data' aria-label='Media type'><option value='17a437aa-7888-4f08-b5e5-23215bb94da8'>application/json</option>
</select>object  

The result of the disabling action.

offlineControllers Array of string   

IDs of the Controllers that were offline during the process and as a result, did not receive the update.

string  (uuid)    

400

JSON error. Check the JSON format.

<select class='api-response-data' aria-label='Media type'><option value='c6ce8c38-5618-44a8-8d3c-adfadd131efd'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='553e89a2-8424-4125-9adb-ed24a4cc2b28'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='ffbf65be-6077-45e3-b716-91c77feb4add'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

404

The requested resource can not be found.

<select class='api-response-data' aria-label='Media type'><option value='276c3543-8a4e-433a-9beb-7bdfeec7574c'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='663c08ad-d9d7-4ed7-a7f3-a04749db6ea1'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

412

Appliance is not in the right state for this operation.

<select class='api-response-data' aria-label='Media type'><option value='9f99cd8e-0f3a-427e-aa9a-98545fd8b651'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

422

Request validation error. Check "errors" array for details.

<select class='api-response-data' aria-label='Media type'><option value='8b653d91-4925-48d1-96b2-d925965dd716'>application/json</option>
</select>Expand Allobject  

Http 422 error for object validation.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

errors Array of object   

List of fields with validation errors.

object  fieldstring    

Name of the field that failed validation.

Examplename
messagestring    

Failure reason.

Examplemay not be null

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='b1aeec16-4ece-4758-a591-35f83855728b'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.