Clerk API (unofficial showcase)
PUT/oauth_applications/{oauth_application_id}/logo

Upload an OAuth application logo

Uploads an image to set or replace an OAuth application's logo. Send the request as multipart/form-data with the image in the file field; supported types are JPEG, PNG, GIF, and WebP, and the file must not exceed 10 MB. You can provide uploader_user_id to credit a user with the upload.

1 parameter · 2 body fields
oauth_application_idstringrequired
The ID of the OAuth application for which to upload a logo.

Multipart form data containing the image file and optional uploader attribution.

uploader_user_idstringoptional
The ID of the user that will be credited with the image upload.
filestringrequired
The image file to upload. Must be an image in JPEG, PNG, GIF, or WebP format and no larger than 10 MB.

5 status codes
200Returns the OAuth application, including its updated logo URL and application configuration.
objectstringrequired
Allowed:oauth_application
idstringrequired
instance_idstringrequired
namestringrequired
client_idstringrequired
client_uristringrequired
client_image_urlstringrequired
dynamically_registeredbooleanrequired
consent_screen_enabledbooleanrequired
pkce_requiredbooleanrequired
audience_uristringrequired
The active application audience URI, whose registry identity is permanently reserved to this application.
token_exchange_enabledbooleanrequired
Whether this confidential application accepts token exchanges from its active audience.
device_authorization_grant_enabledbooleanrequired
publicbooleanrequired
scopesstringrequired
The complete scope ceiling for the OAuth application, as a space-delimited list of built-in and assigned custom scope keys.
redirect_urisarray<string>required
callback_urlstringdeprecatedrequired
Deprecated: Use redirect_uris instead.
authorize_urlstringrequired
token_fetch_urlstringrequired
user_info_urlstringrequired
discovery_urlstringrequired
token_introspection_urlstringrequired
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when authorization is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the OAuth application cannot be found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
413Returned when the request exceeds the permitted size.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is not successful. A 403 is returned when authorization is invalid. A 404 is returned when the OAuth application cannot be found. A 413 is returned when the request exceeds the permitted size. The oauth_application_id path parameter must identify an existing OAuth application. Send the body as multipart/form-data; include file and use a supported image type no larger than 10 MB.