OAuth Applications

Rotate the client secret of the given OAuth application

Changed on

Rotates the OAuth application's client secret. When the client secret is rotated, make sure to update it in authorized OAuth clients.

post/oauth_applications/{oauth_application_id}/rotate_secret

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/oauth_applications/{oauth_application_id}/rotate_secret
  • Auth: HTTP bearer

Path parameters

oauth_application_idstring required

The ID of the OAuth application for which to rotate the client secret

Response

An OAuth application with client secret

object'oauth_application' required
idstring required
instance_idstring required
namestring required
client_idstring required
client_uristring nullable required
client_image_urlstring nullable required
dynamically_registeredboolean required
consent_screen_enabledboolean required
pkce_requiredboolean required
audience_uristring nullable required

The active application audience URI, whose registry identity is permanently reserved to this application.

token_exchange_enabledboolean required

Whether this confidential application accepts token exchanges from its active audience.

device_authorization_grant_enabledboolean required
publicboolean required
scopesstring required

The complete scope ceiling for the OAuth application, as a space-delimited list of built-in and assigned custom scope keys.

redirect_urisstring[] required
callback_urlstring required

Deprecated: Use redirect_uris instead.

authorize_urlstring required
token_fetch_urlstring required
user_info_urlstring required
discovery_urlstring required
token_introspection_urlstring required
created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

client_secretstring

Empty if public client.

Changes

  • 2025-11-107db12d6a9b2aRevision changes
    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

  • 2025-11-10b5f30169c3f3Revision changes
    • info

      added the required property //// to the response with the status