/ 
WebService-Bugzilla-0.001
/ WebService::Bugzilla::FlagActivity

NAME

WebService::Bugzilla::FlagActivity - Bugzilla FlagActivity object and service

VERSION

version 0.001

SYNOPSIS

my $activity = $bz->flag_activity->get;
for my $entry (@{$activity}) {
    say $entry->type->name, ': ', $entry->status;
}

my $by_user = $bz->flag_activity->get_by_requestee('user@example.com');

DESCRIPTION

Provides access to the BMO flag-activity review endpoints. FlagActivity objects represent flag transitions (grants, denials, requests) and provide methods to fetch and filter those entries.

ATTRIBUTES

All attributes are read-only.

attachment_id

Numeric ID of the attachment the flag is associated with, if any.

bug_id

Numeric ID of the associated bug.

creation_time

ISO 8601 datetime when the flag activity was created.

flag_id

Numeric flag ID.

requestee

WebService::Bugzilla::UserDetail of the person the flag was requested from, or undef.

setter

WebService::Bugzilla::UserDetail of the person who set the flag.

status

Flag status string (e.g. +, -, ?).

type

WebService::Bugzilla::FlagActivity::Type describing the flag kind.

METHODS

get

my $entries = $bz->flag_activity->get(%params);

Fetch flag activity entries. Returns an arrayref of WebService::Bugzilla::FlagActivity objects.

get_by_flag_id

my $entries = $bz->flag_activity->get_by_flag_id($flag_id, %params);

Fetch flag activity for a specific flag ID.

get_by_requestee

my $entries = $bz->flag_activity->get_by_requestee($login, %params);

Fetch flag activity where the given user is the requestee.

get_by_setter

my $entries = $bz->flag_activity->get_by_setter($login, %params);

Fetch flag activity set by the given user.

get_by_type_id

my $entries = $bz->flag_activity->get_by_type_id($type_id, %params);

Fetch flag activity for a specific flag type ID.

get_by_type_name

my $entries = $bz->flag_activity->get_by_type_name($name, %params);

Fetch flag activity for a flag type by name (e.g. review).

SEE ALSO

WebService::Bugzilla - main client

WebService::Bugzilla::FlagActivity::Type - flag type metadata

WebService::Bugzilla::UserDetail - lightweight user objects

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