Skip to content
agentuity-cli-cloud-keyvalue-set logo

Cloud Keyvalue Set

agentuity-cli-cloud-keyvalue-set

Set a key and value in the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations

SKILL.md

Full skill instructions

Cloud Keyvalue Set

Set a key and value in the keyvalue storage

Prerequisites

  • Authenticated with agentuity auth login

Usage

agentuity cloud keyvalue set <namespace> <key> <value> [ttl]

Arguments

ArgumentTypeRequiredDescription
<namespace>stringYes-
<key>stringYes-
<value>stringYes-
<ttl>stringNo-

Examples

Store user data:

bunx @agentuity/​cli kv set production user:123 '{"name":"Alice","email":"[email protected]"}'

Store session with 1h TTL:

bunx @agentuity/​cli kv set cache session:abc "session-data-here" --ttl 3600

Cache homepage for 10m:

bunx @agentuity/​cli kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600

Output

Returns JSON object:

{
  "success": "boolean",
  "namespace": "string",
  "key": "string",
  "contentType": "string",
  "durationMs": "number",
  "ttl": "number"
}
FieldTypeDescription
successbooleanWhether the operation succeeded
namespacestringNamespace name
keystringKey name
contentTypestringContent type (application/​json or text/​plain)
durationMsnumberOperation duration in milliseconds
ttlnumberTTL in seconds if set