Uninstall Web API
The Nodinite Web API ships with the Core Services package, so it is uninstalled together with the other Core Services. You uninstall when you need to start over during an install or update, or when you decommission a Nodinite environment. The complete procedure is in Uninstall Nodinite v7.
How to Uninstall
Run the CLI uninstall command from an elevated PowerShell 7 prompt in the extracted ZIP bundle root; see Uninstall commands. It removes the Core Services, including the Web API, but not the agents. Use the Remove Database option only when you also want to delete the databases, or Remove complete environment to tear everything down. During a teardown, agents are deregistered through the Web API, so remove agents before the Core Services, as teardown-environment does.
Warning
Scripts, pipelines, and reports that call the Web API stop working once it is removed. Find and disable them first; each calling system should have its own identity in Log Audits or its own app registration, as recommended in Manage the Web API.
Cleanup for the Web API
After uninstalling, check what the Web API may leave behind:
| Item | What to check | Guidance |
|---|---|---|
| IIS web site and application pool | The Web API site, its application pool, and its HTTP/HTTPS bindings are gone | IIS Application Pool Cleanup |
| TLS certificate | Remove the certificate if no other site uses it | Certificate Cleanup |
| Firewall rules | Remove the inbound rule for the Web API port | Firewall and Network Cleanup |
| Service accounts | Remove the Web API identity if nothing else uses it | Windows Service Accounts and Permissions |
| OAuth 2.0 app registrations | Remove the Web API app registration and the client app registrations of your scripts in Microsoft Entra ID when decommissioning | Azure AD (Entra ID) Cleanup |
| HTTP SPNs | Remove HTTP SPNs registered for the Web API hostname when decommissioning | HTTP SPN for IIS |
Important
Complete the post-uninstall cleanup before you install again in the same place, or when you decommission Nodinite.
Note
Nodinite v6 is no longer supported. To move an existing v6 installation, follow Updating from v6 to v7.
Contact Our Support
If you have questions or problems uninstalling the Web API, see the Support page.