Mira Plugin Uninstall

Uninstall a plugin from Mira App Server

Mira Plugin Uninstall

AI-generated

Overview

The "Mira Plugin Uninstall" node is designed to permanently uninstall a plugin from the Mira App Server. It sends a DELETE request to the server's API endpoint corresponding to the specified plugin ID, effectively removing the plugin and all its associated data. This node is useful in automation workflows where managing plugins dynamically is required, such as cleaning up unused plugins or automating deployment pipelines that include plugin lifecycle management.

Practical examples:

  • Automatically uninstalling a plugin after a testing phase completes.
  • Removing deprecated or vulnerable plugins as part of a security compliance workflow.
  • Managing plugin versions by uninstalling old versions before installing new ones.

Properties

Name Meaning
Token Source Choose where to get the access token from: either from stored credentials or from input data.
Server URL The URL of the Mira App Server (required if token source is from input).
Access Token The access token for authentication, provided directly or via input data (required if token source is from input).
⚠️ Warning: This action will permanently uninstall the plugin and remove all its data! A warning notice emphasizing the irreversible nature of this operation.
Plugin ID The unique identifier of the plugin to uninstall (required).

Output

The node outputs JSON data with the following structure:

{
  "uninstalled": true,
  "pluginId": "string",
  "response": { /* raw response from the Mira API */ },
  "timestamp": "ISO 8601 timestamp string",
  "operation": "uninstall"
}
  • uninstalled: A boolean indicating the plugin was successfully uninstalled.
  • pluginId: The ID of the plugin that was targeted for uninstallation.
  • response: Contains the raw HTTP response from the Mira App Server API call.
  • timestamp: The date and time when the uninstallation occurred.
  • operation: The string "uninstall" indicating the type of operation performed.

This output allows downstream nodes or workflows to confirm the success of the uninstall operation and log relevant details.

Dependencies

  • Requires access to a Mira App Server instance with an API endpoint supporting plugin uninstallation.
  • Needs an access token for authentication, which can be supplied either via stored credentials or directly through input data.
  • The node depends on n8n's HTTP request capabilities and Mira-specific helper functions bundled in shared modules.

Troubleshooting

  • Missing Plugin ID: If the "Plugin ID" property is empty, the node throws an error stating that the Plugin ID is required. Ensure this field is correctly filled.
  • Authentication Errors: If the access token is invalid or missing, the API call will fail. Verify that the token is correct and has sufficient permissions.
  • Server Connectivity Issues: If the Mira App Server URL is incorrect or unreachable, the node will not be able to perform the uninstall operation. Confirm the server URL and network connectivity.
  • Irreversible Action Warning: Users should be cautious because uninstalling a plugin permanently deletes its data. Double-check the plugin ID before execution.

Links and References

  • Mira App Server API documentation (for plugin management endpoints) — consult your Mira App Server provider or internal docs.
  • n8n HTTP Request node documentation for understanding underlying HTTP operations.
  • General best practices for API authentication and token management in n8n workflows.

Discussion