--- name: agentuity-cli-cloud-keyvalue-set description: Set a key and value in the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations version: "0.1.24" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: " [ttl]" metadata: command: "agentuity cloud keyvalue set" tags: "mutating updates-resource slow requires-auth" --- # Cloud Keyvalue Set Set a key and value in the keyvalue storage ## Prerequisites - Authenticated with `agentuity auth login` ## Usage ```bash agentuity cloud keyvalue set [ttl] ``` ## Arguments | Argument | Type | Required | Description | |----------|------|----------|-------------| | `` | string | Yes | - | | `` | string | Yes | - | | `` | string | Yes | - | | `` | string | No | - | ## Examples Store user data: ```bash bunx @agentuity/cli kv set production user:123 '{"name":"Alice","email":"alice@example.com"}' ``` Store session with 1h TTL: ```bash bunx @agentuity/cli kv set cache session:abc "session-data-here" --ttl 3600 ``` Cache homepage for 10m: ```bash bunx @agentuity/cli kv set staging cache:homepage "..." --ttl 600 ``` ## Output Returns JSON object: ```json { "success": "boolean", "namespace": "string", "key": "string", "contentType": "string", "durationMs": "number", "ttl": "number" } ``` | Field | Type | Description | |-------|------|-------------| | `success` | boolean | Whether the operation succeeded | | `namespace` | string | Namespace name | | `key` | string | Key name | | `contentType` | string | Content type (application/json or text/plain) | | `durationMs` | number | Operation duration in milliseconds | | `ttl` | number | TTL in seconds if set |