Skip to main content
command

gws-events-renew — Claude Code command: renew Google Workspace Events subscriptions

Renews or reactivates Google Workspace Events subscriptions so they stop expiring under you. Handy when a listener or script depends on a subscription that is about to lapse.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --command google-workspace/gws-events-renew
Open on GitHub

What gws-events-renew does

The command wraps gws events +renew from the Google Workspace CLI. Pass --name with something like subscriptions/SUB_ID to bring one subscription back. Pass --all to refresh everything expiring inside the --within window, which defaults to 1h; 30m and 2d work too.

The skill behind it works in four steps: confirm gws --version and gws auth status, look up the method with gws schema, assemble the flags, then read errors and retry transient failures. It also points at ../gws-shared/SKILL.md for auth, global flags and security rules. Missing that file? gws generate-skills creates it.

Nothing runs until the CLI is installed and authenticated, so verify gws auth status first. Subscriptions die without periodic renewal, which is why the source suggests pairing --all with a cron job.

What it helps with

  • renew a Workspace Events subscription before it lapses
  • reactivate one subscription by its name
  • refresh every subscription expiring soon
  • schedule recurring renewal from cron
  • check the method schema and required parameters before calling

Example prompts for the agent

  • Renew the subscription subscriptions/SUB_ID with gws-events-renew
  • Refresh all subscriptions expiring in the next two days
  • Check that gws is installed and authenticated, then renew everything

How to install gws-events-renew

1claude-code-templates

npx claude-code-templates@latest --command google-workspace/gws-events-renew

2Manually: put the files in place

.claude/commands/gws-events-renew.md

Call it with /gws-events-renew. For all projects use ~/.claude/commands/

Questions about gws-events-renew

How do I install gws-events-renew in Claude Code?

Run npx claude-code-templates@latest --command google-workspace/gws-events-renew, then place the file at .claude/commands/gws-events-renew.md.

What does gws-events-renew do?

It renews or reactivates Google Workspace Events subscriptions through gws events +renew — a single one by name, or all of them within a time window.

What has to be set up before it works?

The Google Workspace CLI (gws) and working auth, which the skill checks with gws auth status. It also expects ../gws-shared/SKILL.md; gws generate-skills creates that file.

Source text

gws-events-renew.md · MIT
---
allowed-tools: Bash, Read, Write, Edit
argument-hint: "[resource] [method] [flags]"
description: "Google Workspace Events: Renew/reactivate Workspace Events subscriptions."
---

# Google Workspace Events Renew

Execute Google Workspace Events Renew operations: $ARGUMENTS

## Prerequisites

- Google Workspace CLI (`gws`) must be installed
- Authentication configured: Run `gws auth status` to verify
- Review `gws events-renew --help` for all available commands

## Available Resources and Methods

# events +renew

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

Renew/reactivate Workspace Events subscriptions

## Usage

```bash
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

```bash
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](../gws-shared/SKILL.md) — Global flags and auth
- [gws-events](../gws-events/SKILL.md) — All subscribe to google workspace events commands

## Usage

```bash
# List available resources and methods
gws events-renew --help

# Inspect method schema before calling
gws schema events-renew.<resource>.<method>

# Execute command with arguments
gws events-renew $ARGUMENTS
```

## Task

Execute the requested Events Renew operation: $ARGUMENTS

1. **Verify Prerequisites**
   - Check `gws` is installed: `gws --version`
   - Verify authentication: `gws auth status`
   - Review available commands: `gws events-renew --help`

2. **Inspect Method Schema**
   - Before calling any method, inspect its parameters
   - Use `gws schema` to understand required fields
   - Review parameter types and constraints

3. **Execute Operation**
   - Build command with appropriate flags
   - Use `--params` for query/path parameters
   - Use `--json` for request body
   - Handle pagination with `--max-results` or `--page-token`

4. **Error Handling**
   - Check command output for errors
   - Review API quotas and rate limits
   - Handle authentication issues
   - Retry transient failures

---

**License**: Apache License 2.0
**Source**: [Google Workspace CLI](https://github.com/googleworkspace/cli)
**Original Skill**: `gws-events-renew`

© davila7 · MIT · davila7/claude-code-templates

Similar slash commands

All slash commands for Automation and no-code: n8n, Zapier, Make →

From the same set361

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor