Pithub...Members(3pm)

💖 Pithub::Orgs::Members — bestie edition 💖

okay so this is Pithub::Orgs::Members, a page from the User Contributed Perl Documentation manual set (you'll see it filed under Pithub...Members(3pm) in your man reader, no cap). It's the Github v3 Org Members API wrapper and it is, genuinely, so much simpler than it sounds. We're talking orgs. We're talking members. We're talking the four little verbs that decide who's in the group chat and who's on read. 🎀

---

✨ VERSION ✨

version 0.01043

yes bestie, that's the version, write it down, it's giving specific. 💅

---

🌸 METHODS 🌸

Every single method here works the same way: you make a Pithub::Orgs::Members object, you hand it an org and (sometimes) a user, and it hits a Github endpoint for you. Let's go one by one, no skipping, I know you'd skip, don't skip. 🫶

🦋 conceal

• Conceal a user's membership

DELETE /orgs/:org/public_members/:user

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->conceal(
    org  => 'CPAN-API',
    user => 'plu',
);

hiding the friendship. iconic behavior honestly. it's a DELETE on the public members list so their membership goes lowkey instead of highkey. 🙈

🦋 delete

• Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.

DELETE /orgs/:org/members/:user

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->delete(
    org  => 'CPAN-API',
    user => 'plu',
);

⚠️ bestie this is the nuclear option. it's not just "remove from this one list" — they get pulled from all teams and lose all access to the org's repositories. no soft launch, no warning era. be sure. 😭

🦋 is_member

• Check if a user is a member of an organization

GET /orgs/:org/members/:user

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->is_member(
    org  => 'CPAN-API',
    user => 'plu',
);

the vibe check. are they in or are they not in. GET it and find out. ✨

🦋 is_public

• Get if a user is a public member

GET /orgs/:org/public_members/:user

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->is_public(
    org  => 'CPAN-API',
    user => 'plu',
);

not just "are they a member" — are they a member that everyone can SEE. main character vs. private account energy. 👑

🦋 list

• List all users who are members of an organization. A member is a user that belongs to at least 1 team in the organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned. Otherwise only public members are returned.

GET /orgs/:org/members

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->list( org => 'CPAN-API' );

read that description twice, fr fr. a "member" here = someone who's on at least 1 team. and here's the plot twist: if the authenticated user is ALSO in this org, you get both concealed and public members back. if not, you only get the public ones. so what you see depends on who you are. the way that's so very github of them. 🌈

🦋 list_public

• Members of an organization can choose to have their membership publicized or not.

GET /orgs/:org/public_members

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->list_public( org => 'CPAN-API' );

just the public list, just the ones who chose to be seen. it's giving opt-in visibility and honestly? respect. 🍓

🦋 publicize

• Publicize a user's membership

PUT /orgs/:org/public_members/:user

Examples:

my $m = Pithub::Orgs::Members->new;
my $result = $m->publicize(
    org  => 'CPAN-API',
    user => 'plu',
);

the reverse of conceal! PUT it and boom, they're public now. hard launch, no notes. 💅

---

💜 AUTHOR 💜

Johannes Plunien <plu@cpan.org>

shoutout to the author, we love a legend. 🫶

---

🎀 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.

free software, same terms as Perl 5 itself, slay. ✨

---

and that's the whole page, bestie — perl v5.40.1, dated 2025-06-08, filed under Pithub...Members(3pm). go forth and manage your org memberships responsibly, and remember: delete is forever, conceal is just for now. 💖🦋🌸