---
title: "Rotate Application Secret"
method: POST
path: "/api/v1/applications/{app_id}/rotate-secret"
tags: ["Internal: Applications"]
---

# Rotate Application Secret

`POST /api/v1/applications/{app_id}/rotate-secret`

Rotate application secret.

Returns new secret only once - store it securely as it cannot be retrieved again.
The old secret will no longer work after rotation.

## Path parameters

- `app_id` string, required

## Response `200`

Successful Response

- ApplicationReadWithSecret — Schema returned only on creation - contains plain app_secret.
  - `id` string, uuid, required
  - `app_id` string, required
  - `name` string, required
  - `created_at` string, date-time, required
  - `app_secret` string, required

## Other responses

- `422` — Validation Error

---

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