Skip to main content
API Explorer|API Explorer
Infrastructure/Agents
DELETEAgentSince 1.0SynchronousAuth Required

UninstallPlugin

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

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Query Parameters

Request Inputs

Path Parameters

  • agentIdStringRequired

    UUID of the agent from which to uninstall the plugin

  • pluginIdStringRequired

    Unique identifier of the plugin to uninstall

Query Parameters

  • forceBoolean

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

    Example: true

Responses

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"
  }
}

Endpoint

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

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

Operation ID

UninstallPlugin

Permalink

Request Example

curl -X DELETE '{host}/api/v1/agents/{agentId}/plugins/{pluginId}' -H 'Authorization: Bearer {token}'

Response Example

200
{}

Change History

This API has no change history records yet.

View all change history