Pithub...Labels(3pm)

💖 Pithub::Issues::Labels — NAME 💖

okay bestie, welcome to Pithub::Issues::Labels, the Github v3 Issue Labels API module from the Pithub fam. yeah, that's the whole name, we're keeping it cute and keeping it accurate. 🎀

---

✨ VERSION ✨

this is version 0.01043 — write it down, it's iconic.

---

🦋 METHODS 🦋

every single one of these is a lil group-chat text to the GitHub API, and every one of them starts the same way, so get comfy:

my $l = Pithub::Issues::Labels->new;

that's your main character constructor. slay. 💅

💅 add

• Add labels to an issue — yes, plural labels, one issue, go off

POST /repos/:user/:repo/issues/:id/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->add(
    repo     => 'Pithub',
    user     => 'plu',
    issue_id => 1,
    data     => ['Label1', 'Label2'],
);

see how data is an arrayref? that's the labels going in. obsessed. 🍓

🌸 create

• Create a label — brand new label, fresh out the box

POST /repos/:user/:repo/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->create(
    repo => 'Pithub',
    user => 'plu',
    data => {
        color => 'FFFFFF',
        name  => 'some label',
    }
);

color and name, both inside a hashref. that's the vibe check and it passed. ✅

🧚 delete

• Delete a label — it's giving goodbye, no take-backs

DELETE /repos/:user/:repo/labels/:id

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->delete(
    repo     => 'Pithub',
    user     => 'plu',
    label => 1,
);

👑

get

• Get a single label — just the one, she's special

GET /repos/:user/:repo/labels/:id

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->get(
    repo => 'Pithub',
    user => 'plu',
    label => 1,
);

🌈 list

okay this one does three different things, she contains multitudes. not me being shook.

• List all labels for this repository

GET /repos/:user/:repo/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->list(
    repo => 'Pithub',
    user => 'plu'
);

• List labels on an issue — pass issue_id and it knows what you mean

GET /repos/:user/:repo/issues/:id/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->list(
    repo     => 'Pithub',
    user     => 'plu',
    issue_id => 1,
);

• Get labels for every issue in a milestone — yes, milestone girlies get their own endpoint 🎀

GET /repos/:user/:repo/milestones/:id/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->get(
    repo         => 'Pithub',
    user         => 'plu',
    milestone_id => 1
);

🙈 okay so real talk, the example right above literally calls ->get(...) even though we're in the list section. that's what the source says, so that's what you get. i am not editing the queen's words. periodt.

🫶 remove

two whole flavors of taking labels away, we love range.

• Remove a label from an issue

DELETE /repos/:user/:repo/issues/:id/labels/:id

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->delete(
    repo     => 'Pithub',
    user     => 'plu',
    issue_id => 1,
    label => 1,
);

• Remove all labels from an issue — scorched earth, no label key needed

DELETE /repos/:user/:repo/issues/:id/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->delete(
    repo     => 'Pithub',
    user     => 'plu',
    issue_id => 1,
);

💀 and yeah, both examples in the remove section say ->delete(...). again: verbatim, bestie. iykyk.

⭐ replace

• Replace all labels for an issue — out with the old, in with the new, glow-up arc complete

PUT /repos/:user/:repo/issues/:id/labels

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->replace(
    repo     => 'Pithub',
    user     => 'plu',
    issue_id => 1,
    data     => [qw(label3 label4)],
);

💜 update

• Update a label — little refresh, same label, new energy

PATCH /repos/:user/:repo/labels/:id

Examples:

my $l = Pithub::Issues::Labels->new;
my $result = $l->update(
    repo     => 'Pithub',
    user     => 'plu',
    label => 1,
    data     => {
        color => 'FFFFFF',
        name  => 'API',
    }
);

---

👑 AUTHOR 👑

Johannes Plunien <plu@cpan.org> — the literal legend who made this. bow. 🫡

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2011 by Johannes Plunien.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

🌟 and that's the whole page, bestie! brought to you by perl v5.40.1, dated 2025-06-08, and this doc lives under Pithub...Labels(3pm). go forth and label everything. no cap. 💖✨🦋