Actions63
- Account Actions
- Auto-Scale Profile Actions
- Backup Actions
- Cost Estimator Actions
- Desktop Image Actions
- Group Actions
- Host Actions
- Host Pool Actions
- Job Actions
- Network Actions
- Recovery Vault Actions
- Reservation Actions
- Resource Group Actions
- Schedule Actions
- Scripted Action Actions
- Secure Variable Actions
- Storage Actions
- Test Actions
- User Actions
- User Session Actions
Host → Delete
AI-generatedSummary
Deletes a specified host from an Nerdio account via an asynchronous job, optionally waiting for completion.
Inputs
- accountId (required) — The Nerdio account to operate on. Choose from the list, or specify an ID using an expression.
- hostId (required) — The host to delete. Choose from the list, or specify an ID using an expression.
- waitForCompletion — Whether to wait for the delete job to complete before returning. Defaults to true.
- maxWaitSeconds — Maximum time to wait for job completion in seconds. Defaults to 300.
Output shape
A single data item containing the response from the delete request. If waitForCompletion is true, the item includes the final job status and details.
The operation sends a DELETE request to the Nerdio API. If waitForCompletion is true, the node polls for the job status every 5 seconds up to the maxWaitSeconds limit. A timed-out job returns an item with a _timedOut flag and a message.
Examples
Example 1: Delete a host immediately and wait for completion
Select an account and host from the dropdowns, leave 'Wait for Completion' as default true, and 'Max Wait Time' as default 300.
Example 2: Initiate deletion and continue workflow immediately
Set 'Wait for Completion' to false to receive the initial job response without polling.