OAuth token health check (GWS + M365)

← Back to Tasks

Checks Google Workspace (gws) and Microsoft 365 (graph_api) OAuth tokens every 30 minutes. Makes a lightweight API call to each service. If a token is expired or revoked, sends a Telegram alert so Elmar can re-authenticate before scheduled tasks fail.

For Google Workspace Testing-mode OAuth, also reads non-secret auth metadata from ~/.config/gws/credentials-meta.json and sends proactive warning alerts before the estimated refresh-token expiry window (once at <=48h and once at <=24h when metadata is available). Existing legacy credentials without explicit authorization metadata remain "unknown" until the next full Google re-auth.

Status JSON written to ~/workspace/data/oauth-health-status.json for dashboard consumption.

Schedule Every 30 minutes*/30 * * * *

EnabledYes

Run Asshell

Timeout90s

RetryNo

Next Runin 14m (2026-06-13 06:30)

Task Definition

tasks/oauth-health-check.md

Run Asshell

Commandset

Tool-lessNo

BackgroundNo

Runtime profile

Notify destination

python3 /home/lucienne/workspace/scripts/oauth_health_check.py

---
id: oauth-health-check
title: OAuth token health check (GWS + M365)
schedule: "*/30 * * * *"
timeout: 90
retry: false
enabled: true
notify_on: failure
notify_to: dm
run_as: shell
command: "python3 /home/lucienne/workspace/scripts/oauth_health_check.py"
tags: [oauth, health, monitoring, google, m365]
runtime_profile: direct_anthropic_sdk
---

Checks Google Workspace (gws) and Microsoft 365 (graph_api) OAuth tokens every
30 minutes. Makes a lightweight API call to each service. If a token is expired
or revoked, sends a Telegram alert so Elmar can re-authenticate before scheduled
tasks fail.

For Google Workspace Testing-mode OAuth, also reads non-secret auth metadata
from `~/.config/gws/credentials-meta.json` and sends proactive warning alerts
before the estimated refresh-token expiry window (once at <=48h and once at
<=24h when metadata is available). Existing legacy credentials without explicit
authorization metadata remain "unknown" until the next full Google re-auth.

Status JSON written to ~/workspace/data/oauth-health-status.json for dashboard consumption.

Edit Schedule

Frequency

Result:

349

Runs (7d)

349

Completed

Failed

Timeout

100%

Success (7d)

Avg Duration

oauth health monitoring google m365

Run History (50)

Started	Finished	Status	Duration	Output	Log
15m ago	15m ago	completed	1s	GWS: OK \| M365: OK \| checked: 06:00	View log
45m ago	45m ago	completed	1s	GWS: OK \| M365: OK \| checked: 05:30	View log
1h ago	1h ago	completed	1s	GWS: OK \| M365: OK \| checked: 05:00	View log
2h ago	2h ago	completed	1s	GWS: OK \| M365: OK \| checked: 04:30	View log
2h ago	2h ago	completed	1s	GWS: OK \| M365: OK \| checked: 04:04	View log
3h ago	3h ago	completed	1s	GWS: OK \| M365: OK \| checked: 03:31	View log
3h ago	3h ago	completed	1s	GWS: OK \| M365: OK \| checked: 03:00	View log
4h ago	4h ago	completed	1s	GWS: OK \| M365: OK \| checked: 02:30	View log
4h ago	4h ago	completed	1s	GWS: OK \| M365: OK \| checked: 02:02	View log
5h ago	5h ago	completed	1s	GWS: OK \| M365: OK \| checked: 01:30	View log
5h ago	5h ago	completed	1s	GWS: OK \| M365: OK \| checked: 01:00	View log
6h ago	6h ago	completed	1s	GWS: OK \| M365: OK \| checked: 00:30	View log
6h ago	6h ago	completed	1s	GWS: OK \| M365: OK \| checked: 00:00	View log
7h ago	7h ago	completed	1s	GWS: OK \| M365: OK \| checked: 23:30	View log
7h ago	7h ago	completed	1s	GWS: OK \| M365: OK \| checked: 23:00	View log
8h ago	8h ago	completed	1s	GWS: OK \| M365: OK \| checked: 22:30	View log
8h ago	8h ago	completed	1s	GWS: OK \| M365: OK \| checked: 22:00	View log
9h ago	9h ago	completed	1s	GWS: OK \| M365: OK \| checked: 21:30	View log
9h ago	9h ago	completed	1s	GWS: OK \| M365: OK \| checked: 21:00	View log
10h ago	10h ago	completed	1s	GWS: OK \| M365: OK \| checked: 20:30	View log
10h ago	10h ago	completed	1s	GWS: OK \| M365: OK \| checked: 20:00	View log
11h ago	11h ago	completed	1s	GWS: OK \| M365: OK \| checked: 19:30	View log
11h ago	11h ago	completed	1s	GWS: OK \| M365: OK \| checked: 19:04	View log
12h ago	12h ago	completed	1s	GWS: OK \| M365: OK \| checked: 18:30	View log
12h ago	12h ago	completed	1s	GWS: OK \| M365: OK \| checked: 18:01	View log
13h ago	13h ago	completed	1s	GWS: OK \| M365: OK \| checked: 17:30	View log
13h ago	13h ago	completed	1s	GWS: OK \| M365: OK \| checked: 17:03	View log
14h ago	14h ago	completed	1s	GWS: OK \| M365: OK \| checked: 16:30	View log
14h ago	14h ago	completed	1s	GWS: OK \| M365: OK \| checked: 16:00	View log
15h ago	15h ago	completed	1s	GWS: OK \| M365: OK \| checked: 15:30	View log
15h ago	15h ago	completed	1s	GWS: OK \| M365: OK \| checked: 15:00	View log
16h ago	16h ago	completed	1s	GWS: OK \| M365: OK \| checked: 14:30	View log
16h ago	16h ago	completed	1s	GWS: OK \| M365: OK \| checked: 14:00	View log
17h ago	17h ago	completed	1s	GWS: OK \| M365: OK \| checked: 13:30	View log
17h ago	17h ago	completed	1s	GWS: OK \| M365: OK \| checked: 13:00	View log
18h ago	18h ago	completed	1s	GWS: OK \| M365: OK \| checked: 12:30	View log
18h ago	18h ago	completed	1s	GWS: OK \| M365: OK \| checked: 12:09	View log
19h ago	19h ago	completed	1s	GWS: OK \| M365: OK \| checked: 11:30	View log
19h ago	19h ago	completed	1s	GWS: OK \| M365: OK \| checked: 11:00	View log
20h ago	20h ago	completed	1s	GWS: OK \| M365: OK \| checked: 10:30	View log
20h ago	20h ago	completed	1s	GWS: OK \| M365: OK \| checked: 10:00	View log
21h ago	21h ago	completed	1s	GWS: OK \| M365: OK \| checked: 09:30	View log
21h ago	21h ago	completed	1s	GWS: OK \| M365: OK \| checked: 09:00	View log
22h ago	22h ago	completed	1s	GWS: OK \| M365: OK \| checked: 08:30	View log
22h ago	22h ago	completed	1s	GWS: OK \| M365: OK \| checked: 08:03	View log
23h ago	23h ago	completed	1s	GWS: OK \| M365: OK \| checked: 07:30	View log
23h ago	23h ago	completed	1s	GWS: OK \| M365: OK \| checked: 07:00	View log
24h ago	24h ago	completed	1s	GWS: OK \| M365: OK \| checked: 06:30	View log
1d ago	1d ago	completed	1s	GWS: OK \| M365: OK \| checked: 06:01	View log
1d ago	1d ago	completed	1s	GWS: OK \| M365: OK \| checked: 05:30	View log

Comments (0)

No comments yet — add instructions for Luci

←