---
title: "Update a secret"
method: PATCH
path: "/fastedge/v1/secrets/{secret_id}"
tags: ["FastEdge Secrets"]
---

# Update a secret

`PATCH /fastedge/v1/secrets/{secret_id}`

Partially updates secret metadata and/or modifies specific slots

## Path parameters

- `secret_id` integer, required

## Request body

- Secret
  - `name` string — The unique name of the secret.
  - `comment` string — A description or comment about the secret.
  - `app_count` integer — The number of applications that use this secret.
  - `secret_slots` SecretSlot[] — A list of secret slots associated with this secret.
    - `slot` integer, required — Unix timestamp (seconds since epoch) indicating when this secret version becomes active. Use for time-based secret rotation.
    - `value` string — The plaintext secret value. Will be encrypted with AES-256-GCM before storage.
    - `checksum` string — SHA-256 hash of the decrypted value for integrity verification (auto-generated)

## Response `200`

Secret updated successfully, returns updated configuration

- Secret
  - `name` string — The unique name of the secret.
  - `comment` string — A description or comment about the secret.
  - `app_count` integer — The number of applications that use this secret.
  - `secret_slots` SecretSlot[] — A list of secret slots associated with this secret.
    - `slot` integer, required — Unix timestamp (seconds since epoch) indicating when this secret version becomes active. Use for time-based secret rotation.
    - `value` string — The plaintext secret value. Will be encrypted with AES-256-GCM before storage.
    - `checksum` string — SHA-256 hash of the decrypted value for integrity verification (auto-generated)

## Other responses

- `400` — Bad request
- `404` — Not found
- `409` — Entity referenced
- `503` — Service unavailable

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)