Skip to main content
ZStack
Infrastructure/Agents

UninstallPlugin

Uninstall a plugin from an agent, with optional force flag to bypass active check

DELETE/api/v1/agents/{agentId}/plugins/{pluginId}

Operation ID

UninstallPlugin

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • agentId
    StringRequired

    UUID of the agent from which to uninstall the plugin

  • pluginId
    StringRequired

    Unique identifier of the plugin to uninstall

Query Parameters

  • force
    Boolean

    Whether to force uninstall even if plugin is active Whether to force uninstall even if plugin is active

    Example: true

Responses

200 OK

DELETE endpoints return an empty object on success, or a standard error structure on failure.

Success Response

{}

Error Response

{
  "error": {
    "code": "SYS.1001",
    "description": "A message or a operation timeout",
    "details": "Delete resource timeout after 300s"
  }
}