# Wachete

Wachete is a web monitoring service that allows users to track changes on web pages and receive notifications based on specified criteria.

- **Category:** notifications
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `WACHETE`
- **Version:** 20260223_00

## Tools

### Create or update folder

**Slug:** `WACHETE_CREATE_UPDATE_FOLDER`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Folder ID for updates; omit when creating a new folder. |
| `name` | string | No | Name of the folder. |
| `count` | integer | No | Total number of items in the folder. This field is typically managed by the system and may be ignored in requests. |
| `parentId` | string | No | Parent folder ID. Omit or set to null to create/move folder to root level. |
| `failedCount` | integer | No | Number of failed tasks in the folder. This field is typically managed by the system and may be ignored in requests. |
| `pausedCount` | integer | No | Number of paused tasks in the folder. This field is typically managed by the system and may be ignored in requests. |

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

**Slug:** `WACHETE_CREATE_WATCHER`

Create 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

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

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

**Slug:** `WACHETE_DELETE_FOLDER`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | 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

| 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 watcher

**Slug:** `WACHETE_DELETE_WATCHER`

Deletes 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watcher_id` | string | Yes | Unique identifier of the watcher (task) to delete. Use the 'id' field returned from List Watchers or Create Watcher actions. |

#### 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 crawler pages

**Slug:** `WACHETE_GET_CRAWLER_PAGES`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the watcher (task) to retrieve pages from. This must be a portal-type watcher that monitors multiple pages. |

#### 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 Data History

**Slug:** `WACHETE_GET_DATA_HISTORY`

Retrieve 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

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

#### 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 folder content

**Slug:** `WACHETE_GET_FOLDER_CONTENT`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `parentId` | string | No | 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

| 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 watcher by ID

**Slug:** `WACHETE_GET_WATCHER`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watcher_id` | string | Yes | Unique identifier of the watcher (task) to retrieve. Use the 'id' field returned from List Watchers or Create Watcher actions. |

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

### List notifications

**Slug:** `WACHETE_LIST_NOTIFICATIONS`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | No | ID of a specific watcher to filter notifications. If omitted, notifications for all watchers are returned. |
| `to_time` | string | No | End datetime in ISO 8601 format to filter notifications (inclusive). If omitted, no upper time bound is applied. |
| `from_time` | string | No | Start datetime in ISO 8601 format to filter notifications (inclusive). If omitted, no lower time bound is applied. |

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

### List watchers

**Slug:** `WACHETE_LIST_WATCHERS`

List 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Optional search query to filter watchers by name or URL. Leave empty to list all watchers. |

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

### Move Items to Folder

**Slug:** `WACHETE_MOVE_ITEMS_TO_FOLDER`

Move 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_ids` | array | No | List of task (watcher) IDs to move to the destination. Provide this along with folderIds to move multiple items at once. |
| `folder_id` | string | No | Destination folder ID where items will be moved. Use null to move items to the root level (no parent folder). |
| `folder_ids` | array | No | List of folder IDs to move to the destination. Provide this along with taskIds to move multiple items at once. |

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