---
title: "Update Secret"
method: PATCH
path: "/secrets/{id}"
tags: ["secrets", "Secrets"]
---

# Update Secret

`PATCH /secrets/{id}`

Update Secret

## Path parameters

- `id` integer, required

## Response `200`

The Secrets object.

- SecretEntity — SecretEntity model
  - `id` integer — Secret ID.
  - `workspace_id` integer — Workspace ID. 0 means the default workspace.
  - `name` string — Secret name.
  - `description` string — Internal description for your reference.
  - `secret_type` 'basic' | 'token' | 'headers' | 'certificate' | 'key_value' — Secret type.
  - `metadata` object — Non-secret metadata for the Secret type.
  - `value_field_names` string[] — Names of configured secret value fields. Secret values are never returned.
  - `created_at` string, date-time — Secret create date/time.
  - `updated_at` string, date-time — Secret update date/time.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

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