---
title: "Store encrypted key-value pair"
method: PUT
path: "/v1/agent/memory/{ns}/{key}"
tags: ["Agent Memory"]
---

# Store encrypted key-value pair

`PUT /v1/agent/memory/{ns}/{key}`

Store or update a value in agent's encrypted memory. NaCl secretbox encrypted at rest. 1MB quota per agent, 64KB max per value.

## Path parameters

- `ns` string, required
- `key` string, required

## Request body

- object
  - `value` unknown, required
  - `value_type` 'string' | 'json' | 'number' | 'boolean'
  - `ttl` integer — Time-to-live in seconds
  - `client_nonce` string — Client-side encryption nonce passthrough

## Response `200`

Value stored

## Other responses

- `401` — Invalid or missing X-Agent-Key header
- `413` — Value too large or quota exceeded

---

[API](https://skmtc.net/voidly/apis/voidly-api.md) · [All operations](https://skmtc.net/voidly/apis/voidly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voidly/voidly-api/revisions/decbe6fd40a8/schema)