Clerk API (unofficial showcase)
PUT/organizations/{organization_id}/logo

Upload an organization logo

Uploads an image file as the logo for an organization. Send the request as multipart/form-data; files must be no larger than 10 MB and use a supported image content type. A 200 response returns the organization with its logo URL.

1 parameter · 2 body fields
organization_idstringrequired
The unique identifier of the organization whose logo to upload.

Multipart form data containing the required image file and optional uploader information.

uploader_user_idstringoptional
The ID of the user that will be credited with the image upload.
filestringrequired
The image file to use as the organization logo. Must be an image no larger than 10 MB with content type `image/jpeg`, `image/png`, `image/gif`, or `image/webp`.

5 status codes
200Returns the organization object with its logo URL and image status.
objectstringrequired
Allowed:organization
idstringrequired
namestringrequired
slugstringrequired
image_urlstringrequired
has_imagebooleanrequired
members_countintegeroptional
missing_member_with_elevated_permissionsbooleanoptional
pending_invitations_countintegeroptional
max_allowed_membershipsintegerrequired
admin_delete_enabledbooleanrequired
self_serve_sso_enabledbooleanoptional
Whether this organization can configure self-serve enterprise SSO.
self_serve_directory_sync_enabledbooleanoptional
Whether this organization can configure self-serve Directory Sync (SCIM).
public_metadataobjectrequired
private_metadataobjectoptional
created_bystringoptional
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
last_active_atintegeroptional
Unix timestamp of last activity.
role_set_keystringoptional
The key of the [role set](https://clerk.com/docs/guides/organizations/control-access/role-sets) assigned to this organization.
logo_urlstringdeprecatedoptional
400Returned when the request is invalid, such as when the required file is missing or the file content type is unsupported.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when authorization is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the organization is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
413Returned when the request exceeds the maximum allowed file size.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is invalid, including when file is missing or its content type is unsupported. A 403 is returned when authorization is invalid, a 404 when the organization is not found, and a 413 when the request exceeds the allowed size. The organization_id path parameter must identify an existing organization; file is required and must be no larger than 10 MB with content type image/jpeg, image/png, image/gif, or image/webp.