v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB
OAuth Applications

Update an OAuth application

Updates an existing OAuth application

patch/oauth_applications/{oauth_application_id}

Path parameters

oauth_application_idstring required

The ID of the OAuth application to update

Request body

namestring nullable

The new name of the OAuth application. Max length: 256

redirect_urisstring[] nullable

An array of redirect URIs of the new OAuth application

callback_urlstring nullable

The new callback URL of the OAuth application

scopesstring nullable

Define the allowed scopes for the new OAuth applications that dictate the user payload of the OAuth user info endpoint. Available scopes are profile, email, public_metadata, private_metadata. Provide the requested scopes as a string, separated by spaces.

consent_screen_enabledboolean nullable

True to enable a consent screen to display in the authentication flow. This cannot be disabled for dynamically registered OAuth Applications.

pkce_requiredboolean nullable

True to require the Proof Key of Code Exchange (PKCE) flow.

publicboolean nullable

If true, this client is public and you can use the Proof Key of Code Exchange (PKCE) flow.

Example request

{
  "scopes": "profile email public_metadata private_metadata"
}

Response

An OAuth application

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
publicboolean required
scopesstring required
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.