Pithub...s::Keys(3pm)

💖 Pithub::Repos::Keys 💖

okay bestie, so this is the manual for Pithub::Repos::Keys — it's a Perl module, it lives in the Pithub family, and it's your lil keychain to the Github v3 Repo Keys API. ssh keys, deploy keys, the whole vibe. it's giving "i manage keys for repos and i'm slaying while i do it" 🗝️✨

---

🌸 VERSION 🌸

this is version 0.01043. no cap, that's the number. write it down. 📝

---

🎀 METHODS 🎀

four methods. four lil besties. let's go one by one, no skipping, i promised.

✨ create ✨

• Create — yeah she's making a new key. brand new key, who dis. 🔑

the endpoint she hits is literally:

POST /repos/:user/:repo/keys

Examples:

my $k = Pithub::Repos::Keys->new;
my $result = $k->create(
    user => 'plu',
    repo => 'Pithub',
    data => {
        title => 'some key',
        key   => 'ssh-rsa AAA...',
    },
);

see that data hashref? that's where you drop your title and your actual key string. 'ssh-rsa AAA...' is the example, don't come for me about the AAA..., that's verbatim, that's canon. 💅

---

✨ delete ✨

• Delete — bye bye key. it's not you it's the API. 💀

the endpoint:

DELETE /repos/:user/:repo/keys/:id

Examples:

my $k = Pithub::Repos::Keys->new;
my $result = $k->delete(
    user   => 'plu',
    repo   => 'Pithub',
    key_id => 1,
);

note that here it's key_id and not id, even though the path says :id. that's just how she is. iconic behavior honestly. 🫶

---

✨ get ✨

• Get — pull up one single key. like scrolling to find that one text. 👀

the endpoint:

GET /repos/:user/:repo/keys/:id

Examples:

my $k = Pithub::Repos::Keys->new;
my $result = $k->get(
    user   => 'plu',
    repo   => 'Pithub',
    key_id => 1,
);

again with the key_id. consistent queen. ✨

---

✨ list ✨

• List — show me ALL the keys. the whole collection. the full roster. 📋

the endpoint:

GET /repos/:user/:repo/keys

Examples:

my $k = Pithub::Repos::Keys->new;
my $result = $k->list(
    user => 'plu',
    repo => 'Pithub',
);

no key_id here obviously, because we're listing, not getting, keep up bestie 🦋

---

👑 AUTHOR 👑

Johannes Plunien <plu@cpan.org>

like. the actual legend. the author. we stan. 💜

---

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

so basically: it's free, you can share it, remix it, whatever — just keep it under the same Perl 5 terms. lowkey the most chill license energy. 🍓

---

okay and for the cute lil sign-off moment: this page was generated with perl v5.40.1, dated 2025-06-08, and it's the Pithub...s::Keys(3pm) page from the User Contributed Perl Documentation. mwah. go forth and manage your keys, bestie 💅💖🌸