Add API Endpoint to Trigger Website Asset Refresh

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 workflowsMatches 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 websiteThe 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]/refreshCurrent 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

Please authenticate to join the conversation.

Upvoters
Status

In Review

Board

API

Tags

Automation & workflow

Date

3 months ago

Subscribe to request

Get notified by email when there are changes.