> ## Documentation Index > Fetch the complete documentation index at: https://wb-21fd5541-sdk-testing-latest.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Registry export const GitHubLink = ({url}) => GitHub source ; ## class Registry ```python theme={null} (service_api: 'ServiceApi', organization: 'str', entity: 'str', name: 'str', attrs: 'RegistryFragment | None' = None) ``` ## Description A single registry in the Registry. ## Args * `service_api`: * `organization`: * `entity`: * `name`: * `attrs`: ## Properties ### property id The unique ID for this registry. ### property full\_name Full name of the registry including the `wandb-registry-` prefix. ### property name Name of the registry without the `wandb-registry-` prefix. ### property entity Organization entity of the registry. ### property organization Organization name of the registry. ### property description Description of the registry. ### property allow\_all\_artifact\_types Return whether all artifact types are allowed in the registry. If `True`, artifacts of any type can be added. If `False`, artifacts are restricted to the types listed in `artifact_types`. ### property artifact\_types Returns the artifact types allowed in the registry. If `allow_all_artifact_types` is `True` then `artifact_types` reflects the types previously saved or currently used in the registry. If `allow_all_artifact_types` is `False` then artifacts are restricted to the types in `artifact_types`. Note: Previously saved artifact types cannot be removed. ### property created\_at Timestamp of when the registry was created. ### property updated\_at Timestamp of when the registry was last updated. ### property path ### property visibility Visibility of the registry. ## Methods ### method add\_members ```python theme={null} self, *members: 'User | UserMember | Team | TeamMember | str' ``` Adds users or teams to this registry. ##### Arguments * `members`: The users or teams to add to the registry. Accepts `User` objects, `Team` objects, or their string IDs. ##### Raises * `TypeError`: If no members are passed as arguments. * `ValueError`: If unable to infer or parse the user or team IDs. ##### Examples ```python theme={null} import wandb api = wandb.Api() # Fetch an existing registry registry = api.registry(name="my-registry", organization="my-org") user1 = api.user(username="some-user") user2 = api.user(username="other-user") registry.add_members(user1, user2) my_team = api.team(name="my-team") registry.add_members(my_team) ``` ### method collections ```python theme={null} self, filter: 'dict[str, Any] | None' = None, order: 'str | None' = None, per_page: 'PositiveInt' = 100, start: 'str | None' = None ``` Returns the collections belonging to this registry. ##### Arguments * `filter`: Optional mapping of filters to apply to the collections query. * `order`: Optional string to specify the order of the results. If prefixed with '+', sorts ascending (default). If prefixed with '-', sorts descending. * `per_page`: The number of results to fetch per page. Usually there is no reason to change this. * `start`: Pagination cursor for resuming a past query, captured from a previous paginator's `.cursor` attribute. ### method create ```python theme={null} api: 'Api', organization: 'str', name: 'str', visibility: "Literal['organization', 'restricted']", description: 'str | None' = None, artifact_types: 'list[str] | None' = None ``` Create a new registry. The registry name must be unique within the organization. This function should be called using `api.create_registry()` ##### Arguments * `api`: The W\&B API instance. * `organization`: The name of the organization. * `name`: The name of the registry (without the `wandb-registry-` prefix). * `visibility`: The visibility level ('organization' or 'restricted'). * `description`: An optional description for the registry. * `artifact_types`: An optional list of allowed artifact types. ##### Raises * `ValueError`: If a registry with the same name already exists in the organization or if the creation fails. ### method delete ```python theme={null} self ``` Delete the registry. This is irreversible. ### method load ```python theme={null} self ``` Load registry attributes from the backend. ### method members ```python theme={null} self ``` Returns the current members (users and teams) of this registry. ### method remove\_members ```python theme={null} self, *members: 'User | UserMember | Team | TeamMember | str' ``` Removes users or teams from this registry. ##### Arguments * `members`: The users or teams to remove from the registry. Accepts `User` objects, `Team` objects, or their string IDs. ##### Raises * `TypeError`: If no members are passed as arguments. * `ValueError`: If unable to infer or parse the user or team IDs. ##### Examples ```python theme={null} import wandb api = wandb.Api() # Fetch an existing registry registry = api.registry(name="my-registry", organization="my-org") user1 = api.user(username="some-user") user2 = api.user(username="other-user") registry.remove_members(user1, user2) old_team = api.team(name="old-team") registry.remove_members(old_team) ``` ### method save ```python theme={null} self ``` Save registry attributes to the backend. ### method team\_members ```python theme={null} self ``` Returns the current member teams of this registry. ### method update\_member ```python theme={null} self, member: 'User | UserMember | Team | TeamMember | str', role: 'MemberRole | str' ``` Updates the role of a member (user or team) within this registry. ##### Arguments * `member`: The user or team to update the role of. Accepts a `User` object, `Team` object, or their string ID. * `role`: The new role to assign to the member. May be one of: - "admin" - "member" - "viewer" - "restricted\_viewer" (if supported by the W\&B server) ##### Raises * `ValueError`: If unable to infer the user or team ID. ##### Examples Make all users in the registry admins ```python theme={null} import wandb api = wandb.Api() # Fetch an existing registry registry = api.registry(name="my-registry", organization="my-org") for member in registry.user_members(): registry.update_member(member.user, role="admin") ``` ### method user\_members ```python theme={null} self ``` Returns the current member users of this registry. ### method versions ```python theme={null} self, filter: 'dict[str, Any] | None' = None, per_page: 'PositiveInt' = 100, start: 'str | None' = None ``` Returns the artifact versions belonging to this registry. ##### Arguments * `filter`: Optional mapping of filters to apply to the artifact versions query. * `per_page`: The number of results to fetch per page. Usually there is no reason to change this. * `start`: Pagination cursor for resuming a past query, captured from a previous paginator's `.cursor` attribute.