agentuity-cli-cloud-keyvalue-delete
Delete a key from the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The Agentuity Cloud Keyvalue Delete skill is a specialized developer tool designed for managing cloud-based storage resources. It allows users to programmatically remove specific keys from the Agentuity key-value store via CLI commands, facilitating efficient data lifecycle management, cache clearing, and environment maintenance within the Agentuity cloud platform.
Use Cases
- Data Cleanup: Securely remove outdated or redundant user records and temporary data from production or staging namespaces to maintain storage hygiene.
- Cache Invalidation: Manually purge specific cache keys, such as session tokens or homepage data, to ensure immediate data consistency and freshness for end-users.
- DevOps Automation: Integrate into CI/CD pipelines or automated scripts to clear configuration flags and state data during environment teardowns or re-deployments.
| name | agentuity-cli-cloud-keyvalue-delete |
|---|---|
| description | Delete a key from the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.103" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<namespace> <key>" |
| command | "agentuity cloud keyvalue delete" |
| tags | "destructive deletes-resource slow requires-auth" |
Cloud Keyvalue Delete
Delete a key from the keyvalue storage
Prerequisites
- Authenticated with
agentuity auth login - Project context required (run from project directory or use
--project-id)
Usage
agentuity cloud keyvalue delete <namespace> <key>
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<namespace> |
string | Yes | - |
<key> |
string | Yes | - |
Examples
Delete user data:
bunx @agentuity/cli kv delete production user:123
Delete cached session:
bunx @agentuity/cli kv delete cache session:abc
Delete homepage cache (using alias):
bunx @agentuity/cli kv rm staging cache:homepage
Output
Returns JSON object:
{
"success": "boolean",
"namespace": "string",
"key": "string",
"durationMs": "number"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether the operation succeeded |
namespace |
string | Namespace name |
key |
string | Key name |
durationMs |
number | Operation duration in milliseconds |