> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ageneral.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Secrets

> Agent-scoped secret names and REST workflow

## Overview

**Secrets** map **names** to **values** for an **agent** inside a **project**. Ageneral encrypts stored values and supplies them to the agent runtime when configuration updates run.

## REST workflow

1. **Put** — **`PUT /v1/agents/{agent_id}/secrets/{name}`** with body **`{ "value": "…" }`**.
2. **List** — **`GET /v1/agents/{agent_id}/secrets`** returns configured **names**.
3. **Delete** — **`DELETE /v1/agents/{agent_id}/secrets/{name}`** removes a secret.

After writes, allow a short interval before relying on new values inside **OpenClaw**.

## Reference

See **API reference** → **Agents** for schemas and response shapes.

## Next steps

* [Connectors](/guides/agents/connectors)
* [Channels](/guides/agents/channels)
* [OpenClaw runtime](/guides/agents/openclaw)
* [Agents](/agents)