---
title: "Update a secret"
method: POST
path: "/secret"
tags: ["🧩 Secret management"]
---

# Update a secret

`POST /secret`

Update a secret and override the value, the name cannot be overridden

## Request body

- Secrets
  - `name` string — The name of the secret used as a reference on the value
  - `description` string — The description of the secret to identify it more easily
  - `value` string — The value of the secret it will not be exposed in the interface

## Response `200`

Secrets information

- object
  - `result` 'success' | 'error', required — Result of the request
  - `action` 'updateSecret', required — The id of the action
  - `data` object, required
    - `secrets` object[], required — List of API version and status
      - `name` string, required — The name of the secret used as a reference on the value
      - `description` string, required — The description of the secret to identify it more easily

---

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