# Agentuity CLI Cloud Keyvalue Set > Set a key and value in the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations - Skill: `majiayu000/agentuity-cli-cloud-keyvalue-set` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds add majiayu000/agentuity-cli-cloud-keyvalue-set` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/agentuity-cli-cloud-keyvalue-set/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - License: Apache-2.0 - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/agentuity-cli-cloud-keyvalue-set --- # Cloud Keyvalue Set Set a key and value in the keyvalue storage ## Prerequisites - Authenticated with `agentuity auth login` - Project context required (run from project directory or use `--project-id`) ## 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 |