---
title: "Set Secrets"
method: PUT
path: "/agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets"
tags: ["Secrets"]
---

# Set Secrets

`PUT /agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets`

Set one or more secrets/config values.

    If redeploy=True (default) and environment has active deployment,
    triggers redeploy with same image but new secrets_snapshot.

## Path parameters

- `namespace_slug` string, required
- `agent_name` string, required
- `env_name` string, required

## Request body

- SetEnvVarRequest — Request to set environment variable(s). Matches design spec (deployment-addendum-rollback-and-envvars.md): { "secrets": { "OPENAI_API_KEY": {"value": "sk-xxx", "is_secret": true}, "LOG_LEVEL": {"value": "debug", "is_secret": false} }, "redeploy": true }
  - `redeploy` boolean — If true and env has active deployment, trigger redeploy with new secrets
  - `secrets` object, required — Dict of {key: {value, is_secret}} to set

## Response `200`

Successful Response

- SetEnvVarResponse — Response after setting environment variables.
  - `count` integer, required — Number of variables set
  - `redeployed` boolean — Whether a redeploy was triggered
  - `updated` string[], required — Keys that were set
  - `version_id` string, nullable — New version ID if redeployed

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.dev/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)