---
title: "Rotate an owned confidential client secret. Returns it once; the previous secret immediately stops working. Requires verified assurance and current revision."
method: POST
path: "/auth/apps/rotate-secret"
tags: ["app_registration"]
---

# Rotate an owned confidential client secret. Returns it once; the previous secret immediately stops working. Requires verified assurance and current revision.

`POST /auth/apps/rotate-secret`

## Request

- Base URL: `https://obeliskgate.com`
- URL: `https://obeliskgate.com/auth/apps/rotate-secret`
- Auth: API key in cookie `obelisk_session`

## Request body

- object
  - `clientId` string: string
  - `expectedRevision` unknown

## Response `200`

Success.

## Other responses

- `default`: Error — { ok:false, reason:<code>, message?:<human> } on failures; HTTP status mirrors it.

---

[API](https://skmtc.dev/obeliskgate/apis/obelisk-api.md) · [All operations](https://skmtc.dev/obeliskgate/apis/obelisk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/obeliskgate/apis/obelisk-api/revisions/b99b2069699b?raw)