It would be great to have a dedicated API endpoint to programmatically trigger a refresh of website assets in Hudu, similar to the "Refresh" button available in the web GUI.
Use Case:
Being able to trigger a refresh of all monitored website assets on a schedule (e.g., nightly) would allow us to ensure all expirations (like domain registration) are up to date for the alert emails. Currently, there's no way to trigger a refresh via the API - users must manually click "Refresh" on each website in the GUI, which doesn't scale.
Proposed Solution:
Add a new endpoint to the Hudu API:
Option 1 (by ID):
POST /api/v1/websites/{id}/refresh
Option 2 (by slug):
POST /api/v1/websites/{slug}/refresh
Option 3 (bulk refresh):
POST /api/v1/websites/refresh_all
Response format: 200 OK (or 202 Accepted for async queueing)
Why This Matters:
Enables automation of website monitoring workflows
Matches functionality available in the web GUI (/websites/{slug}/refresh)
Particularly useful for MSPs managing multiple client sites who need scheduled refreshes
Current Workaround (insufficient):
Using the existing PUT endpoint /websites/{id} only updates metadata - it doesn't trigger a fresh scan of the website
The GUI refresh endpoint exists but requires GUI session auth and isn't accessible via the documented REST API
References:
GUI refresh URL pattern: https://[instance]/websites/[slug]/refresh
Current Website API endpoints: GET/POST/PUT/DELETE /websites and /websites/{id}
Existing refreshed_at field in Website model (read-only) confirms refresh functionality exists internally