rt-email-...uth-tokens(8)

💌 rt-email-expiring-auth-tokens — the manual page, bestie edition

okay so you're reading the rt-email-...uth-tokens(8) page from the Request Tracker Reference and honestly? this one's a whole vibe. it's giving "polite reminder emails, but automated." let's get into it 💅

---

✨ NAME ✨

rt-email-expiring-auth-tokens — email users about expiring auth tokens

like. the name literally says it. no cap. 🎀

---

🌸 SYNOPSIS 🌸

rt-email-expiring-auth-tokens --expires-by '7 days' --template 'Auth tokens expiring in 7 days in HTML' [--email-to 'admin@domain.com,other@domain.com'] [--user-filter 'apiuser,otheruser']

that's the whole move right there. the [...] bits are optional, the rest is the moment. periodt. ✨

---

🦋 DESCRIPTION 🦋

This script is a tool to email users about their expiring auth tokens. that's it. that's the job. she's a notifier and she's slaying it. 💖

now here's the tea, and it's important: you may have some users used only for API access that do not have valid email addresses. yes bestie, real problem. nobody to email = email goes nowhere = nobody fixes their token = chaos. 😭

so use the email-to and user-filter options to send emails about their expiring tokens to a valid email address instead. redirect the mail, save the day. you're the main character here. 👑

---

💅 OPTIONS 💅

every flag, all of them, no skips. this is the good part.

• expires-by — all auth tokens that will expire between today and this date will be included in the email. format is YYYY-MM-DD or any date format supported by Time::ParseDate. so yes, talk to her however you like, she speaks fluent date. 🗓️
• expires-on — all auth tokens that expire on this exact date will be included in the email. one day, one moment, very specific of you, we love that. format is YYYY-MM-DD or any date format supported by Time::ParseDate. same energy as above. ✨
• template — specify name or id of template you want to use. you got a cute little email template? name it or number it, she'll find it. 🎀
• email-to — send the email to these email addresses instead of the user's email address. accepts a comma separated string of email addresses. this is the one for your API-only ghost users fr fr. 👻
• user-filter — a comma separated string of usernames for filtering the users to check for expiring auth tokens. narrow the search, get specific, love a curated list. 🌈
• print — print the expiring auth tokens to STDOUT; don't email them. dry run energy. look at the list, nod, feel powerful. 👀
• help — print this message. the classic. she's always there for you. 🫶

---

⚠️ heads up bestie: both expires-by and expires-on take YYYY-MM-DD or any date format supported by Time::ParseDate. don't get creative with formats she doesn't know, or you'll be sad. 💀

---

🌟 a lil sign-off 🌟

this glorious piece of documentation lives under perl v5.40.1, dated 2026-06-21. screenshot it, bookmark it, send it to the group chat. iykyk. 💜

go email those users. go be iconic. bye bestie!! 🧚✨