Organizations

Upload a logo for the organization

Changed on

Set or replace an organization's logo, by uploading an image file. This endpoint uses the multipart/form-data request content type and accepts a file of image type. The file size cannot exceed 10MB. Only the following file content types are supported: image/jpeg, image/png, image/gif, image/webp.

put/organizations/{organization_id}/logo

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organizations/{organization_id}/logo
  • Auth: HTTP bearer

Path parameters

organization_idstring required

The ID of the organization for which to upload a logo

Request body multipart/form-data

uploader_user_idstring

The ID of the user that will be credited with the image upload.

filestring binary required

Response

An organization with a logo URL.

object'organization' required
idstring required
namestring required
slugstring required
image_urlstring required
has_imageboolean required
members_countinteger
missing_member_with_elevated_permissionsboolean
pending_invitations_countinteger
max_allowed_membershipsinteger required
admin_delete_enabledboolean required
self_serve_sso_enabledboolean

Whether this organization can configure self-serve enterprise SSO.

public_metadataobject required
private_metadataobject
created_bystring
created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

last_active_atinteger

Unix timestamp of last activity.

role_set_keystring nullable

The key of the role set assigned to this organization.

logo_urlstring

Changes

  • 2025-11-10a490313abffaRevision changes
    • warning

      removed the optional property //// from the response with the status

  • 2025-11-107db12d6a9b2aRevision changes
    • info

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