Skip to main content
Wachete logo
  • Category: notifications
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: WACHETE
  • Version: 20261030_00

Tools

Slug: WACHETE_CREATE_UPDATE_FOLDERCreate a new folder or update an existing folder in Wachete. Folders help organize watchers into hierarchical structures. Omit the id parameter to create a new folder, or provide an id to update an existing one.

Input Parameters

string
Folder ID for updates; omit when creating a new folder.
string
Name of the folder.
integer
Total number of items in the folder. This field is typically managed by the system and may be ignored in requests.
string
Parent folder ID. Omit or set to null to create/move folder to root level.
integer
Number of failed tasks in the folder. This field is typically managed by the system and may be ignored in requests.
integer
Number of paused tasks in the folder. This field is typically managed by the system and may be ignored in requests.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_CREATE_WATCHERCreate or update a Wachete watcher to monitor web page changes. Watchers check pages at specified intervals and send alerts when changes are detected. Use SinglePage mode for monitoring a single page, or Portal mode to crawl and monitor multiple linked pages.

Input Parameters

string
Watcher ID for updates; omit when creating new watcher.
string
required
URL to monitor.
string
required
Name of the watcher.
string
required
XPath selector for the element to watch.
array
List of alert configurations. Each alert specifies when to notify.
string ("SinglePage" | "Portal")
Type of monitoring job: ‘SinglePage’ for single page or ‘Portal’ for crawling multiple pages.
object
URL filters for Portal crawling. Only applicable when jobType=‘Portal’.
integer
Crawling depth for Portal mode (1, 2, or 3). Only applicable when jobType=‘Portal’.
integer
Monitoring interval in seconds (e.g., 3600 for hourly, 86400 for daily).
array
Notification endpoints for alerts. Use Email type for default email, or Webhook with a URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_DELETE_FOLDERPermanently deletes a folder along with all nested subfolders and watchers (monitoring tasks). This is a destructive operation that cannot be undone. Use when you need to remove an entire folder structure. All subfolders and monitoring tasks within the folder will be permanently deleted. Obtain the folder ID from the Get Folder Content action before calling. Example: “Delete the folder with ID 576b3f7e-e126-4e92-9b95-f72a8d187a18”

Input Parameters

string
required
Unique identifier of the folder to delete. Use the ‘id’ field returned from Get Folder Content action. Deletes the folder and all nested subfolders and watchers within it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_DELETE_WATCHERDeletes a website monitoring watcher (task) by its unique ID. This operation is idempotent - deleting a non-existent or already-deleted watcher will succeed without error. Use when you need to permanently remove a monitoring task. Obtain the watcher ID from List Watchers or Create Watcher actions before calling. Example: “Delete the watcher with ID 974b65b5-6ccb-4996-812c-5a678c2455e8”

Input Parameters

string
required
Unique identifier of the watcher (task) to delete. Use the ‘id’ field returned from List Watchers or Create Watcher actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_GET_CRAWLER_PAGESRetrieves all pages monitored by a crawler watcher (portal monitor). Use this to get detailed information about each page being tracked including URLs, last check timestamps, content changes, and error states. Only works with portal-type watchers that monitor multiple pages.

Input Parameters

string
required
Unique identifier of the watcher (task) to retrieve pages from. This must be a portal-type watcher that monitors multiple pages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_GET_DATA_HISTORYRetrieve history for a wachet (monitor). Returns timestamped snapshots of monitored content showing when changes occurred. Supports time range filtering and optional diff with previous value. Use continuationToken for pagination when retrieving large histories.

Input Parameters

string
required
Wachet (watcher) ID to retrieve history for.
string
Time interval end (ISO 8601 format). If not provided, retrieves up to present.
string
Time interval start (ISO 8601 format). If not provided, retrieves from unlimited past.
integer
Number of history items to return. If more items are available, continuationToken is returned for pagination.
boolean
If true, returns diff with previous value for each history item. Default is false.
string
Token for requesting the next result page. Obtained from previous response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_GET_FOLDER_CONTENTRetrieves the contents of a Wachete folder, including subfolders and watcher tasks. Use this tool to: - List all subfolders and tasks in the root folder (omit parentId) - List contents of a specific folder (provide parentId) - Navigate the folder hierarchy using the path breadcrumb - Check task statuses and last check data Returns subfolders, tasks with their monitoring details, folder path, and pagination token.

Input Parameters

string
ID of the folder to list contents for. Omit this parameter or pass null to retrieve the root folder contents. Use folder IDs from the ‘subfolders’ array to navigate into subfolders.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_GET_WATCHERRetrieve complete watcher (monitor) definition by ID. Use this to get detailed configuration and current status of a specific monitoring task including URL, XPath selector, alerts, notification endpoints, and latest check results.

Input Parameters

string
required
Unique identifier of the watcher (task) to retrieve. Use the ‘id’ field returned from List Watchers or Create Watcher actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_LIST_NOTIFICATIONSRetrieves notifications from Wachete watchers. Returns notifications for all watchers or filtered by specific watcher ID and/or time range. Useful for checking recent changes detected by your web page monitors.

Input Parameters

string
ID of a specific watcher to filter notifications. If omitted, notifications for all watchers are returned.
string
End datetime in ISO 8601 format to filter notifications (inclusive). If omitted, no upper time bound is applied.
string
Start datetime in ISO 8601 format to filter notifications (inclusive). If omitted, no lower time bound is applied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_LIST_WATCHERSList all monitoring watchers (tasks) configured in your Wachete account. Optionally filter by search query. Returns up to 500 watchers with details including name, URL, monitoring settings, and notification configuration.

Input Parameters

string
Optional search query to filter watchers by name or URL. Leave empty to list all watchers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WACHETE_MOVE_ITEMS_TO_FOLDERMove tasks (watchers) and folders to a specified destination folder. Use this to organize your monitoring structure by relocating items within the folder hierarchy. Provide at least one of folderIds or taskIds to move items. Set folderId to null to move items to root level.

Input Parameters

array
List of task (watcher) IDs to move to the destination. Provide this along with folderIds to move multiple items at once.
string
Destination folder ID where items will be moved. Use null to move items to the root level (no parent folder).
array
List of folder IDs to move to the destination. Provide this along with taskIds to move multiple items at once.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not