# Fluxguard

Fluxguard is an AI-powered website change detection and monitoring tool that helps businesses track, analyze, and respond to critical changes in web-based data.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Tools:** 23
- **Triggers:** 0
- **Slug:** `FLUXGUARD`
- **Version:** 20260211_00

## Tools

### Acknowledge Fluxguard Alert

**Slug:** `FLUXGUARD_ACKNOWLEDGE_ALERT`

Acknowledge a Fluxguard alert by marking it as reviewed. This action creates an acknowledgement record for the specified alert ID. Since Fluxguard's public API does not provide a native acknowledge endpoint, this action fetches the sample webhook endpoint to provide alert context and generates a synthetic acknowledgement response with timestamp and status information. The response includes a 'matched' field indicating whether the provided alert ID matches the sample webhook data, allowing validation of alert IDs.

### Add FluxGuard Page

**Slug:** `FLUXGUARD_ADD_PAGE`

Tool to add a new page for monitoring in FluxGuard. This action can: 1. Create a new site with a page (when siteId/sessionId are not provided) 2. Add a page to an existing site (when siteId/sessionId are provided) When creating a new site, you can optionally assign it to categories and provide a nickname. Use this when you need to start monitoring a URL for changes.

### Create FluxGuard Site Category

**Slug:** `FLUXGUARD_CREATE_SITE_CATEGORY`

Creates a new site category in FluxGuard for organizing monitored websites. Site categories help you group and manage your monitored sites logically (e.g., by environment like 'Production' or 'Staging', by purpose like 'Marketing' or 'E-commerce', or by client/team). Use this action to create categories before adding sites, making it easier to filter and organize your monitoring dashboard. The returned category ID can be used when adding sites to assign them to this category.

### Create Webhook

**Slug:** `FLUXGUARD_CREATE_WEBHOOK`

Creates a webhook endpoint registration in FluxGuard to receive real-time notifications when changes are detected on monitored pages. When changes occur, FluxGuard will POST JSON data to your specified URL containing change details, diff information, and file references. Use this when you need to integrate FluxGuard change detection into your own systems, automation workflows, or alerting infrastructure. Note: Only one webhook can be active per account. Creating a new webhook will replace any existing webhook configuration.

### Delete Fluxguard Page

**Slug:** `FLUXGUARD_DELETE_PAGE`

Permanently deletes a monitored page from FluxGuard along with all its captured snapshots and version history. This is a destructive operation that cannot be undone. Use this when you need to remove a page that is no longer needed for monitoring. The operation is idempotent - deleting an already-deleted page will succeed without error. To obtain the required IDs (site_id, session_id, page_id), first use FLUXGUARD_ADD_PAGE to create a page or FLUXGUARD_GET_SITES to list existing sites and their pages.

### Delete Fluxguard Site

**Slug:** `FLUXGUARD_DELETE_SITE`

Permanently deletes a monitored site and all associated data including sessions, pages, and captured versions. This operation is idempotent - deleting a non-existent site returns success. Use when you need to remove a site from FluxGuard monitoring.

### Delete Webhook

**Slug:** `FLUXGUARD_DELETE_WEBHOOK`

Permanently removes a webhook from your FluxGuard account by its ID. After deletion, the webhook will no longer receive notifications about monitored page changes. This operation is idempotent - deleting a non-existent webhook will succeed without error. Use this tool when you need to remove a webhook configuration that is no longer needed.

### Get FluxGuard Account Data

**Slug:** `FLUXGUARD_GET_ACCOUNT_DATA`

Retrieves comprehensive account information for the authenticated FluxGuard organization. Returns account details including: organization ID, available monitoring credits, subscription plan level, account status, number of monitored sites, notification settings, and configured alert flags (danger, warning, serenity, resolved). This is a read-only operation that requires no parameters and can be called multiple times without side effects. Useful for checking account status, credit balance, and configuration before performing monitoring operations.

### Get Sample Alert Data

**Slug:** `FLUXGUARD_GET_ALERT`

Retrieve sample alert data from Fluxguard webhooks. IMPORTANT: Fluxguard's API does not provide a dedicated endpoint for retrieving individual alerts by ID. This action returns sample webhook data as a representative alert example. The alert_id parameter is accepted for consistency but does not affect the returned data. For listing multiple alerts, use the Get Alerts action instead.

### Get FluxGuard Alerts

**Slug:** `FLUXGUARD_GET_ALERTS`

Retrieves sample alert data from FluxGuard's webhook payload endpoint. Returns structured alert information showing what change detection alerts look like, including site details, page information, change types, timestamps, and file references. Note: FluxGuard's public API (as of 2026) does not provide a dedicated endpoint for listing actual alerts. This action uses the /account/webhook/sample endpoint to return representative sample data. For real-time alerts, configure webhooks in your FluxGuard account settings. Useful for: Understanding alert structure, testing webhook integrations, and viewing sample change detection data.

### Get All FluxGuard Categories

**Slug:** `FLUXGUARD_GET_ALL_CATEGORIES`

Retrieves all categories defined in your FluxGuard account. Use this tool when you need to: - List all available categories for organizing sites or pages - Get category IDs for use in other operations - Check what categories exist before creating new ones This is a read-only operation that returns both site and page categories. No parameters are required - simply call this action to get all categories.

### Get FluxGuard Change Details

**Slug:** `FLUXGUARD_GET_CHANGE`

Retrieve detailed information about a specific change detected by FluxGuard. Use this tool when you have a change identifier (session ID, page ID, site ID, or URL) from a FluxGuard webhook notification or another FluxGuard action, and need to fetch the complete change details including capture files, diffs, and metadata. Note: FluxGuard does not provide a direct API endpoint for individual change retrieval. This action queries the sample webhook endpoint and matches the provided identifier against available changes.

### Get Changes

**Slug:** `FLUXGUARD_GET_CHANGES`

Tool to retrieve a list of all detected changes across monitored sites. Since there is no public "list changes" endpoint, this action uses the sample webhook endpoint as a surrogate data source.

### Get Sample Webhook Payload

**Slug:** `FLUXGUARD_GET_SAMPLE_WEBHOOK`

Tool to retrieve a sample webhook payload. Use when you need to inspect the structure of webhook notifications.

### Get FluxGuard Site Details

**Slug:** `FLUXGUARD_GET_SITE`

Retrieves detailed information about a specific monitored site by its ID. This action fetches site information from FluxGuard's webhook sample endpoint, which provides site metadata extracted from recent monitoring events. The site must exist in your FluxGuard account and have recent monitoring activity. Use this when you need to: - Verify a site exists and retrieve its URL/origin - Get the user-assigned nickname for a site - Confirm site configuration details Note: FluxGuard's API doesn't provide a direct GET /site/{id} endpoint, so this action derives site details from the webhook sample data. Sites without recent activity may not appear in results.

### Get FluxGuard Sites

**Slug:** `FLUXGUARD_GET_SITES`

Retrieves a list of websites being monitored by FluxGuard for change detection. Returns site information including unique IDs, URLs, and names. Each site represents a website that FluxGuard is actively monitoring for content changes. Use this to discover what sites are configured in the account, get site IDs for other operations, or check the monitoring status of websites. Note: This uses the FluxGuard webhook sample endpoint as the API does not provide a dedicated sites listing endpoint.

### Get Snapshot

**Slug:** `FLUXGUARD_GET_SNAPSHOT`

Retrieve detailed information about a specific Fluxguard snapshot by its identifier. A snapshot is a captured state of a webpage including HTML content, screenshots, text content, network activity (HAR), and metadata. Snapshots are created when Fluxguard monitors websites for changes. This action searches for snapshots by matching the provided identifier against various ID fields (actionId, captureId, and IDs embedded in URLs). Since Fluxguard does not provide a direct snapshot lookup API, this action queries the sample webhook endpoint and searches for matching snapshots. Returns comprehensive snapshot details including: - Capture files (HTML, screenshots, text, network data) - Site, session, and page information - Change detection metadata (AI summaries, diffs, alarms) - Cloud storage URLs for accessing capture files

### Get Site Snapshots

**Slug:** `FLUXGUARD_GET_SNAPSHOTS`

Retrieve sample snapshot data from Fluxguard. Returns capture information including URLs, timestamps, file artifacts, and links to view diffs. Use this to see what snapshot data is available in your Fluxguard account, including capture files stored in S3 and web console URLs. This endpoint returns sample webhook data which contains snapshot information. The response includes site/page details, capture timestamps, file references (HTML, screenshots, text, network HAR), and URLs to view changes in the Fluxguard web console.

### Get Current FluxGuard Account

**Slug:** `FLUXGUARD_GET_USER`

Retrieves the authenticated FluxGuard account's information as a user profile. Returns details about the current organization's account including ID, status, creation date, and last update timestamp. This provides account information in a user-friendly format for the authenticated API key's organization.

### Get FluxGuard Users (Not Available)

**Slug:** `FLUXGUARD_GET_USERS`

Verify FluxGuard account access and return users information. IMPORTANT LIMITATION: FluxGuard API does not provide a public endpoint for listing organization users or team members. This action will always return an empty users list. This tool exists to: 1. Verify that the API credentials are valid and the account is accessible 2. Maintain API compatibility for future updates if a users endpoint is added 3. Provide a consistent interface for user management operations If you need to manage users, you must use the FluxGuard web interface.

### Get Webhook Details

**Slug:** `FLUXGUARD_GET_WEBHOOK`

Retrieve detailed configuration of a specific webhook by its ID. Returns webhook details including URL, API version, secret key, creation timestamp, and site categories. Use this when you need current settings for a particular webhook. To get a list of available webhook IDs, use the Get Webhooks action first.

### Get FluxGuard Webhooks

**Slug:** `FLUXGUARD_GET_WEBHOOKS`

Retrieves all configured webhooks for the FluxGuard account. Use this action to list all webhook endpoints that are configured to receive FluxGuard change notifications. Each webhook includes its URL, secret for signature verification, API version, and associated site categories. No parameters required - returns all webhooks for the authenticated account.

### Fluxguard Webhook Notification

**Slug:** `FLUXGUARD_WEBHOOK_NOTIFICATION`

Simulate Fluxguard webhook notification by sending change detection data to your webhook endpoint. Use this tool to test your webhook receiver implementation by sending it a properly formatted Fluxguard webhook payload with optional HMAC signature authentication. This helps verify your endpoint can receive and process Fluxguard change notifications correctly. Note: This does NOT retrieve data from Fluxguard or trigger actual monitoring - it only sends test notifications to your webhook URL.
