agentuity-cli-cloud-sandbox-snapshot-list
List snapshots. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The Agentuity Cloud Sandbox Snapshot List skill enables developers and DevOps engineers to programmatically retrieve and manage snapshots within the Agentuity cloud platform. It streamlines infrastructure management by providing a structured overview of sandbox states, facilitating better version control, environment auditing, and resource tracking directly through the Agentuity CLI.
Use Cases
- Infrastructure Auditing: Quickly list and review all available sandbox snapshots to maintain a clear record of environment versions and history.
- Resource Cleanup: Identify outdated or redundant snapshots to optimize cloud storage and manage platform resources effectively.
- Environment Recovery: Locate specific snapshot IDs required for restoring sandboxes to previous stable states or replicating environments for testing.
- Automation Workflows: Integrate snapshot listing into CI/CD pipelines or automated scripts to verify environment readiness before deployment.
| name | agentuity-cli-cloud-sandbox-snapshot-list |
|---|---|
| description | List snapshots. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud sandbox snapshot list" |
| tags | "slow requires-auth" |
Cloud Sandbox Snapshot List
List snapshots
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox snapshot list [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--sandbox |
string | Yes | - | Filter by sandbox ID |
--limit |
number | Yes | - | Maximum number of results |
--offset |
number | Yes | - | Offset for pagination |
Examples
List all snapshots:
bunx @agentuity/cli cloud sandbox snapshot list
List snapshots for a specific sandbox:
bunx @agentuity/cli cloud sandbox snapshot list --sandbox sbx_abc123
Output
Returns JSON object:
{
"snapshots": "array",
"total": "number"
}
| Field | Type | Description |
|---|---|---|
snapshots |
array | List of snapshots |
total |
number | Total number of snapshots |