---
title: "Update app secrets belonging to an app"
method: POST
path: "/v1/apps/{app_name}/secrets"
tags: ["Secrets"]
---

# Update app secrets belonging to an app

`POST /v1/apps/{app_name}/secrets`

## Path parameters

- `app_name` string, required

## Request body

- AppSecretsUpdateRequest
  - `values` object

## Response `200`

OK

- AppSecretsUpdateResp
  - `Version` integer — DEPRECATED
  - `secrets` AppSecret[]
    - `created_at` string
    - `digest` string
    - `name` string
    - `updated_at` string
    - `value` string
  - `version` integer

## Other responses

- `400` — Bad Request

## Changes

- **2026-08-20** `9e6a180c40a3` — 1 warning
  - added the new `name_taken` enum value to the `status` response property for the response status `400`
- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/apps/:app_name/secrets/post.md)

---

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