# 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
- **Composio Managed App Available?** N/A
- **Tools:** 13
- **Triggers:** 0
- **Slug:** `FLUXGUARD`
- **Version:** 20260312_00

## Tools

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL of the page to monitor. This is the web page that FluxGuard will track for changes. |
| `siteId` | string | No | ID of an existing site to add this page to. Must be provided together with sessionId. If omitted, a new site will be created automatically. |
| `sessionId` | string | No | ID of the session containing the existing site. Must be provided together with siteId. If omitted, a new site and session will be created automatically. |
| `categories` | array | No | List of category IDs to assign to the newly created site. Only applies when creating a new site (when siteId/sessionId are not provided). Use FLUXGUARD_GET_ALL_CATEGORIES to retrieve available category IDs. |
| `categoryId` | string | No | Single category ID to assign to the newly created site. Only applies when creating a new site. Cannot be used with 'categories' parameter. |
| `categoryName` | string | No | Name of a single category to assign to the newly created site. Only applies when creating a new site. The category must already exist in your FluxGuard account. |
| `siteNickname` | string | No | Human-readable nickname for the newly created site. Only applies when creating a new site (when siteId/sessionId are not provided). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name for the new site category. Use descriptive names to organize your monitored sites (e.g., 'Production', 'Development', 'Client Sites'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The HTTPS URL endpoint where FluxGuard will POST JSON notifications when changes are detected on monitored pages. Must be publicly accessible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | Unique identifier of the specific page to permanently delete. Obtain this from the response of FLUXGUARD_ADD_PAGE action. |
| `site_id` | string | Yes | Unique identifier of the site containing the page to delete. Obtain this from the response of FLUXGUARD_ADD_PAGE or FLUXGUARD_GET_SITES actions. |
| `session_id` | string | Yes | Unique identifier of the monitoring session under the site. Obtain this from the response of FLUXGUARD_ADD_PAGE action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | Unique identifier of the site to delete. Accepts both short alphanumeric IDs (e.g., '53z1wfkw098tj') and UUID format (e.g., '331dd37e-f2af-4323-9424-0e0cc4dee8aa') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FluxGuard Page Data

**Slug:** `FLUXGUARD_GET_PAGE_DATA`

Tool to retrieve comprehensive data for a monitored page in FluxGuard. This action fetches detailed information about a specific page including its URL, monitoring status, capture history, and metadata. Use this when you need to verify a page exists, check its monitoring status, or retrieve page configuration details. The page must be identified by its site_id, session_id, and page_id, which are typically obtained from FLUXGUARD_ADD_PAGE when creating a page or from FLUXGUARD_GET_SITES when listing existing sites and their pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | Unique identifier of the specific page to retrieve data for. Obtain this from FLUXGUARD_ADD_PAGE action. |
| `site_id` | string | Yes | Unique identifier of the site containing the page. Obtain this from FLUXGUARD_ADD_PAGE or FLUXGUARD_GET_SITES actions. |
| `session_id` | string | Yes | Unique identifier of the monitoring session under the site. Obtain this from FLUXGUARD_ADD_PAGE action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | Identifier for the user to retrieve. Use 'current' or 'me' to get the authenticated account's information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Initiate FluxGuard Crawl

**Slug:** `FLUXGUARD_INITIATE_CRAWL`

Tool to initiate a crawl for a session identified by siteId and sessionId. Use when you need to start monitoring a site for changes after adding pages with FLUXGUARD_ADD_PAGE.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | Unique identifier of the site to crawl. Can be alphanumeric (e.g., '559kz95p1x7de') or UUID format. Use FLUXGUARD_ADD_PAGE to create a site and obtain a site ID. |
| `session_id` | string | Yes | Unique identifier of the session within the site. Obtained from FLUXGUARD_ADD_PAGE when adding a page to a site. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `secret` | string | No | Optional webhook signing secret to generate HMAC-SHA256 signature in fluxguard-signature header for authentication |
| `payload` | object | Yes | Complete webhook payload with change detection data to send |
| `webhook_url` | string | Yes | The webhook endpoint URL where the notification will be sent (e.g., https://your-server.com/webhooks/fluxguard) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |