agentuity-cli-cloud-deployment-remove
Remove a specific deployment. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-deployment-remove skill provides a streamlined way to programmatically delete specific cloud deployments on the Agentuity platform. It enhances DevOps efficiency by allowing authenticated users to manage resource lifecycles directly through the agent, supporting both standard and forced removal workflows to maintain a clean and cost-effective cloud environment.
Use Cases
- Automated Environment Cleanup: Automatically remove temporary or ephemeral cloud deployments after CI/CD testing phases are completed to prevent resource leakage.
- Infrastructure Decommissioning: Safely decommission outdated or redundant application versions as part of a scheduled infrastructure maintenance or migration plan.
- Multi-Project Resource Management: Efficiently prune specific deployments across various project IDs to ensure organized resource allocation and reduce unnecessary cloud overhead.
- Emergency Resource Removal: Use the 'force' option to quickly terminate problematic or unresponsive deployments during incident response or troubleshooting.
| name | agentuity-cli-cloud-deployment-remove |
|---|---|
| description | Remove a specific deployment. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.104" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<deployment_id>" |
| command | "agentuity cloud deployment remove" |
| tags | "destructive deletes-resource slow requires-auth requires-deployment" |
Cloud Deployment Remove
Remove a specific deployment
Prerequisites
- Authenticated with
agentuity auth login - cloud deploy
Usage
agentuity cloud deployment remove <deployment_id> [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<deployment_id> |
string | Yes | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--project-id |
string | Yes | - | Project ID |
--force |
boolean | No | false |
Force removal without confirmation |
Examples
Remove with confirmation:
bunx @agentuity/cli cloud deployment remove dep_abc123xyz
Remove without confirmation:
bunx @agentuity/cli cloud deployment remove dep_abc123xyz --force
Remove deployment from specific project:
bunx @agentuity/cli cloud deployment remove deployment-2024-11-20 --project-id=proj_abc123xyz
Output
Returns JSON object:
{
"success": "boolean",
"projectId": "string",
"deploymentId": "string"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether the removal succeeded |
projectId |
string | Project ID |
deploymentId |
string | Deployment ID that was removed |