v10

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-0582185581.9 KB
OAuth Apps

Regenerate client secret

Generates a fresh client secret for an OAuth app. The previous secret is invalidated immediately — any client still presenting it will fail token exchange at POST /oauth2/token until updated.

The new secret is returned in this response only and cannot be retrieved later. Pair this call with credential propagation to every integration that uses the app. If the rotation was triggered by a suspected leak, also call POST /oauth-clients/{appId}/revoke-all-tokens to invalidate already-issued access and refresh tokens instead of waiting for their natural expiry.

Creator-only: even org admins cannot rotate secrets for other users' apps.

post/oauth-clients/{appId}/regenerate-secret

Path parameters

appIdstring required

OAuth app ID

Response

New client secret generated

messagestring required
clientIdstring required

OAuth client ID (unchanged)

clientSecretstring required

New client secret (store securely; previous secret is invalidated)

Example response

{
  "message": "Client secret regenerated successfully"
}