View as Markdown
Rendex icon

Rendex ACTION

Update Watch

Update a watch, including pausing or resuming it. Only the fields you set are changed. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Rendex account once, then configure and run Update Watch from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "rendex-update-watch",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    rendex: { authProvisionId: "apn_xxxxxxx" },
    watchId: "Watch",
    url: "URL",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Watch inputs
Property Type Description
watchId Watch string
The watch to act on.
Required Dynamic
url URL string
New page URL to monitor. Changing it re-baselines the watch on the next run.
Optional
name Name string
A human-friendly label for the watch.
Optional
intervalMinutes Interval (minutes) integer
Minutes between automatic checks. Per-plan floors apply (Free 1440, Starter 180, Pro 30, Enterprise 5).
Optional
diffMode Diff Mode string
How a change is detected: visual (pixel diff), text (extracted text), or both.
Optional
threshold Threshold string
Fraction of the page (between 0 and 1) that must change to count as a change. Defaults to 0.01.
Optional
webhookUrl Webhook URL string
URL that receives an HMAC-signed POST when a change is detected. Requires a Starter plan or higher.
Optional
notifyEmail Notify Email string
Email to alert on a change. Must match the email on your Rendex account.
Optional
paused Paused boolean
When true, the watch is created/left paused and is not scheduled (no credits charged).
Optional
renderFullPage Render Full Page boolean
Capture (and diff) the entire scrollable page. Defaults to true for watches.
Optional
renderSelector Render Selector string
Monitor only the element matching this CSS selector instead of the whole page.
Optional
ignoreText Ignore Text string[]
Text patterns stripped from both captures before text-diffing so volatile substrings (timestamps, rotating prices, CSRF tokens) don't trigger a change. Wrap a pattern in /…/flags for a regex; anything else is a case-insensitive substring.
Optional
minTextChars Minimum Text Change (chars) integer
A text change must add and remove at least this many characters to count — drops micro-edits.
Optional
suppressWhilePresent Suppress While Present string[]
While the page text contains any of these strings (e.g. Out of stock, Loading), the run is treated as unchanged — no alert, no baseline drift.
Optional
uaMode User-Agent Mode string
Fetch identity for the watch: auto (lead with the RendexWatch UA, retry once with a browser identity if blocked), identify (always the RendexWatch UA), or stealth (always a standard browser identity).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
rendex-update-watch
Version
0.0.2
App
Rendex
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes