agentuity-cli-cloud-sandbox-delete
Delete a sandbox. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-sandbox-delete skill enables seamless management of cloud resources by providing a secure, authenticated method to delete sandboxes on the Agentuity platform. It streamlines infrastructure maintenance, allowing developers and DevOps engineers to programmatically remove environments, optimize cloud costs, and ensure environment hygiene through a simple CLI-driven interface.
Use Cases
- Automated Environment Teardown: Integrate into CI/CD pipelines to automatically delete ephemeral testing sandboxes after a build or test suite is completed.
- Cloud Cost Management: Programmatically identify and remove idle or expired sandboxes to prevent unnecessary billing and optimize infrastructure spend.
- Development Workflow Cleanup: Quickly decommission local or remote development environments once a feature has been merged or a project is archived.
- Resource Governance: Maintain a clean cloud workspace by enforcing lifecycle policies through automated deletion of temporary resources.
| name | agentuity-cli-cloud-sandbox-delete |
|---|---|
| description | Delete a sandbox. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<sandboxId>" |
| command | "agentuity cloud sandbox delete" |
| tags | "destructive deletes-resource slow requires-auth" |
Cloud Sandbox Delete
Delete a sandbox
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox delete <sandboxId> [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<sandboxId> |
string | Yes | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--confirm |
boolean | No | false |
Skip confirmation prompt |
Examples
Delete a sandbox:
bunx @agentuity/cli cloud sandbox delete abc123
Delete using alias:
bunx @agentuity/cli cloud sandbox rm abc123
Delete without confirmation prompt:
bunx @agentuity/cli cloud sandbox rm abc123 --confirm
Output
Returns JSON object:
{
"success": "boolean",
"sandboxId": "string",
"durationMs": "number",
"message": "string"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether the operation succeeded |
sandboxId |
string | Sandbox ID |
durationMs |
number | Operation duration in milliseconds |
message |
string | Status message |