gws-events-renew
googleworkspace/cli
Renew or reactivate Google Workspace Events subscriptions before they expire.
What is gws-events-renew?
Extends the lifetime of Workspace Events subscriptions to keep them active. Use this skill when subscriptions are approaching expiration or to bulk-renew multiple subscriptions at once.
- Renew individual subscriptions by name
- Bulk-renew all subscriptions expiring within a specified time window
- Specify custom expiration windows (e.g., 1h, 30m, 2d)
- Integrate with cron jobs for automated subscription maintenance
How to install gws-events-renew
npx skills add null --skill gws-events-renew- gws CLI installed
- Google Workspace authentication configured (see gws-shared skill)
- Existing Workspace Events subscriptions to renew
How to use gws-events-renew
- 1.Run `gws events +renew --name subscriptions/SUB_ID` to renew a specific subscription
- 2.Or run `gws events +renew --all --within 2d` to renew all subscriptions expiring within 2 days
- 3.Optionally set up a cron job with the --all flag to automate renewal
Use cases
- Prevent Workspace Events subscriptions from expiring in production
- Bulk-renew multiple subscriptions before a 2-day maintenance window
- Set up automated renewal via cron to keep subscriptions continuously active
- Reactivate a specific subscription that is about to expire
- Google Workspace administrators
- DevOps engineers managing event integrations
- Teams running automated Workspace event pipelines
gws-events-renew FAQ
Subscriptions expire if not renewed periodically, causing event delivery to stop.
Yes, use the --all flag with a --within time window (e.g., --within 2d) to renew all subscriptions expiring in that period.
Use --all with a cron job to keep subscriptions alive automatically.
Common formats include 1h (1 hour), 30m (30 minutes), and 2d (2 days).
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-events-renew description: "Google Workspace Events: Renew/reactivate Workspace Events subscriptions." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws events +renew --help"
events +renew
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Renew/reactivate Workspace Events subscriptions
Usage
gws events +renew
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--name | — | — | Subscription name to reactivate (e.g., subscriptions/SUB_ID) |
--all | — | — | Renew all subscriptions expiring within --within window |
--within | — | 1h | Time window for --all (e.g., 1h, 30m, 2d) |
Examples
gws events +renew --name subscriptions/SUB_ID
gws events +renew --all --within 2d
Tips
- Subscriptions expire if not renewed periodically.
- Use --all with a cron job to keep subscriptions alive.
See Also
- gws-shared — Global flags and auth
- gws-events — All subscribe to google workspace events commands
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.