Back to the BSR
Manuals / The Buf Schema Registry (BSR) / System Model / Organizations

Manage Organizations

An organization allows you to collaborate. You will be able to assign different roles to a user so that they can see, edit, create new resources under the organization, and/or delete all the organization's existing resources.

Create organization

To create a new organization, log in to the Buf Schema Registry, click on Show all under the "Your organization" section, and then select Create Organization.


When setting up a new organization, there are a few important things to keep in mind:

  • The organization name must be unique and between 3 and 32 characters in length. It can only contain lowercase letters, numbers, or hyphens (-).
  • You have the option to link an organization URL later in the repository settings.
  • You can also provide a description of the organization, which can be up to 350 characters in length.
  • Additionally, you can provide an organization logo to make the org memorable and identifiable.

During beta, organization names cannot be changed without deleting and recreating the organization and all its contents. Please choose the name carefully.

Delete organization

Deleting the organization is a permanent action, and cannot be undone. You must first delete all repositories, templates, and plugins owned by the organization.

Buf Schema Registry URLs

User settings

User profile{user}

Organization profile{organization}

Members of an organization{organization}/members

Organizations a user belongs to{user}/organizations

Module repository{owner}/{repository}

Repository documentation{owner}/{repository}/docs

Repository code{owner}/{repository}/tree

Generated respository assets{owner}/{repository}/assets

Repository history{owner}/{repository}/history

Hosted templates associated with an owner{owner}/templates

Hosted template{owner}/templates/{template}

Remote plugins associated with an owner{owner}/plugins

Remote plugin{owner}/plugins/{plugin}

Generated documentation for a specific reference{owner}/{repository}/docs/{reference}

Generated assets for a specific reference{owner}/{repository}/assets/{reference}