NAME

WebService::Bugzilla::Group - Bugzilla Group object and service

VERSION

version 0.001

SYNOPSIS

my $group = $bz->group->get('admin');
say $group->name, ': ', $group->description;

my $groups = $bz->group->search(membership => 1);

DESCRIPTION

Provides access to the Bugzilla Group API. Group objects represent user groups in Bugzilla and expose attributes about the group plus helper methods to create, fetch, search, and update groups.

ATTRIBUTES

All attributes are read-only and lazy.

description

Human-readable description of the group.

icon_url

URL for the group's icon, if any.

is_active

Boolean. Whether the group is active.

is_bug_group

Boolean. Whether the group controls bug visibility.

membership

Membership information for the authenticated user.

name

Group name.

user_regexp

Regular expression for automatic membership.

METHODS

create

my $group = $bz->group->create(%params);

Create a new group. See POST /rest/group.

get

my $group = $bz->group->get($id_or_name);

Fetch a group by numeric ID or name. See GET /rest/group/{id}.

Returns a WebService::Bugzilla::Group, or undef if not found.

my $groups = $bz->group->search(%params);

Search for groups. See GET /rest/group.

Returns an arrayref of WebService::Bugzilla::Group objects.

update

my $updated = $group->update(%params);
my $updated = $bz->group->update($id, %params);

Update a group. See PUT /rest/group/{id}.

SEE ALSO

WebService::Bugzilla - main client

https://bmo.readthedocs.io/en/latest/api/core/v1/group.html - Bugzilla Group REST API

AUTHOR

Dean Hamstead <dean@fragfest.com.au>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2026 by Dean Hamstead.

This is free software, licensed under:

The MIT (X11) License