changedetection_create_watch
Creates a watch to monitor a URL for changes, with an optional dry-run preview before confirming the write.
Instructions
Create a watch. POST /api/v1/watch. Requires url. Supports processor restock_diff, price fields, and llm_intent / llm_change_summary. Omit confirm for a dry-run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Deprecated. Comma-separated tag names, matched case-insensitively and created when missing. | |
| url | Yes | URL to monitor. | |
| body | No | ||
| tags | No | Tag UUIDs. Unknown UUIDs are stored but resolve to no group. | |
| proxy | No | ||
| title | No | Watch title, not the HTML page title. | |
| method | No | ||
| paused | No | ||
| confirm | No | Set to the boolean true to execute the write. Omit this field for a dry-run preview. false and the string true are rejected. | |
| headers | No | HTTP headers for the fetch. Authorization and cookie values are redacted in output. | |
| processor | No | text_json_diff is the default. restock_diff tracks stock and price. | |
| conditions | No | ||
| llm_intent | No | Plain-English intent for AI change filtering. | |
| ignore_text | No | ||
| extract_text | No | ||
| link_to_open | No | Human-facing URL to open instead of url. Empty string means use url. | |
| trigger_text | No | ||
| browser_steps | No | ||
| fetch_backend | No | Fetcher. Common values: system, html_requests, html_webdriver. | |
| in_stock_only | No | restock_diff: only notify on in-stock transitions. | |
| include_filters | No | ||
| webdriver_delay | No | ||
| filter_text_added | No | ||
| notification_body | No | ||
| notification_urls | No | Apprise notification URLs for this watch. Tokens in URLs are redacted in output. | |
| check_unique_lines | No | ||
| llm_change_summary | No | Instructions for the AI to summarise changes in notifications. | |
| notification_muted | No | ||
| notification_title | No | ||
| time_between_check | No | ||
| filter_text_removed | No | ||
| ignore_status_codes | No | ||
| llm_backend_profile | No | Watch: boolean on/off. Tag: true/false/null ternary AI control. | |
| notification_format | No | ||
| strip_ignored_lines | No | ||
| time_schedule_limit | No | ||
| filter_text_replaced | No | ||
| follow_price_changes | No | restock_diff: track price changes. | |
| trim_text_whitespace | No | ||
| subtractive_selectors | No | ||
| conditions_match_logic | No | ||
| remove_duplicate_lines | No | ||
| use_page_title_in_list | No | ||
| llm_change_summary_mode | No | ||
| notification_screenshot | No | ||
| track_ldjson_price_data | No | ||
| extract_lines_containing | No | ||
| sort_text_alphabetically | No | ||
| webdriver_js_execute_code | No | ||
| text_should_not_be_present | No | ||
| history_snapshot_max_length | No | ||
| price_change_threshold_percent | No | ||
| time_between_check_use_default | No | ||
| filter_failure_notification_send | No |