Fluxguard | Composio Docs

Overview

SLUG: FLUXGUARD

Description

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.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Fluxguard

Create an auth config

Use the dashboard to create an auth config for the Fluxguard toolkit. This allows you to connect multiple Fluxguard accounts to Composio for agents to use.

Select App

Navigate to Fluxguard.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Fluxguard Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 fluxguard_auth_config_id = "ac_YOUR_FLUXGUARD_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Fluxguard for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, fluxguard_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Fluxguard toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["FLUXGUARD"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

FLUXGUARD_ACKNOWLEDGE_ALERT

Tool Name: Acknowledge Fluxguard Alert

Description

Tool to acknowledge an alert, marking it as reviewed. Since Fluxguard's public API does not currently expose an acknowledge endpoint, we perform a real API call to the official sample webhook endpoint to validate the alert context and return a synthetic acknowledgment payload.

Action Parameters

alert_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_ADD_PAGE

Tool Name: Add FluxGuard Page

Description

Tool to add a new page for monitoring. Use when you need to start monitoring a URL by adding it to FluxGuard.

Action Parameters

FLUXGUARD_CREATE_SITE_CATEGORY

Tool Name: Create FluxGuard Site Category

Description

Tool to create a new site category in FluxGuard. Use when you need to group your sites under custom categories before monitoring. Invoke after authenticating your account.

Action Parameters

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_CREATE_WEBHOOK

Tool Name: Create Webhook

Description

Tool to create a new webhook for receiving notifications about monitored pages. Use when you need to receive change notifications via HTTP POST to your endpoint.

Action Parameters

url

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_DELETE_PAGE

Tool Name: Delete Fluxguard Page

Description

Tool to delete a monitored page. Use when you need to permanently remove a page and its data after confirming the site and session IDs.

Action Parameters

page_id

stringRequired

session_id

stringRequired

site_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_DELETE_SITE

Tool Name: Delete Fluxguard Site

Description

Tool to delete a monitored site. Use when you need to permanently remove a site and all its data.

Action Parameters

site_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_DELETE_WEBHOOK

Tool Name: Delete Webhook

Description

Tool to delete a webhook. Use when you need to remove a webhook by its ID.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_ACCOUNT_DATA

Tool Name: Get FluxGuard Account Data

Description

Tool to retrieve general account information for your FluxGuard organization. Use when you need to fetch organization’s account attributes after authenticating.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_ALERT

Tool Name: Get Alert Details

Description

Tool to retrieve details of a specific alert. Use after obtaining the alert ID. Returns full alert information.

Action Parameters

alert_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_ALERTS

Tool Name: Get FluxGuard Alerts

Description

Tool to retrieve all alerts generated by site changes. Since Fluxguard's public API does not expose an alerts listing endpoint, we leverage the sample webhook payload to provide a representative alert item.

Action Parameters

limit

integer

offset

integer

pageId

integer

since

string

siteId

integer

status

string

until

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_ALL_CATEGORIES

Tool Name: Get FluxGuard Site Categories

Description

Tool to retrieve all site categories. Use when you need to list every category defined in your organization.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_CHANGE

Tool Name: Get Fluxguard Change

Description

Tool to retrieve details of a change by its ID. Use after you have a valid change ID to fetch its details.

Action Parameters

change_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_CHANGES

Tool Name: Get Changes

Description

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.

Action Parameters

limit

integer

offset

integer

page_id

integer

since

string

site_id

integer

status

string

until

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_SAMPLE_WEBHOOK

Tool Name: Get Sample Webhook Payload

Description

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

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_SITE

Tool Name: Get FluxGuard Site Details

Description

Tool to retrieve details of a specific monitored site by its ID. Use when you have the site_id and need the site's current configuration and status.

Action Parameters

site_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_SITES

Tool Name: Get FluxGuard Sites

Description

Tool to retrieve a list of all monitored sites. Use when you need to enumerate all sites after authenticating.

Action Parameters

categoryId

integer

limit

integer

offset

integer

string

status

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_SNAPSHOT

Tool Name: Get Snapshot

Description

Tool to retrieve details of a specific snapshot by its ID. Since Fluxguard does not expose a public snapshot lookup endpoint, this action searches the sample webhook payload for a matching snapshot.

Action Parameters

snapshot_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_SNAPSHOTS

Tool Name: Get Site Snapshots

Description

Tool to retrieve a list of all site snapshots. Use when you need to enumerate available snapshots for your account.

Action Parameters

limit

integer

offset

integer

pageId

integer

since

string

siteId

integer

until

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_USER

Tool Name: Get FluxGuard User Details

Description

Tool to retrieve details that represent the current FluxGuard account as a user-like object. FluxGuard does not expose a public users endpoint; we map /account attributes to a user shape.

Action Parameters

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_USERS

Tool Name: Get FluxGuard Users

Description

Tool to retrieve all users in the organization. Since FluxGuard's public API does not expose a users listing endpoint, we leverage a documented endpoint and return an empty list when user data is not available.

Action Parameters

limit

integer

offset

integer

role

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_WEBHOOK

Tool Name: Get Webhook Details

Description

Tool to retrieve details of a specific webhook by its ID. Use when you need to fetch up-to-date configuration of a webhook.

Action Parameters

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_GET_WEBHOOKS

Tool Name: Get FluxGuard Webhooks

Description

Tool to retrieve all configured webhooks. Use when you need a list of webhook configurations.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

FLUXGUARD_WEBHOOK_NOTIFICATION

Tool Name: Fluxguard Webhook Notification

Description

Tool to send change data to your webhook endpoint. Use when a modification is detected.

Action Parameters

payload

objectRequired

secret

string

webhook_url

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired