Update an alert rule — Pricefy API Reference
PUT /v1/alert-rules/{id} — Updates an alert rule and returns it. Send only the settings you want to change: each top-level
field you send replaces that setting as a whole (for example `condition` or `notifications`), and
every field you leave out keeps its current value.
- Inside an object you send, every field that has a default when creating the rule is required:
read the current `settings` with `GET /v1/alert-rules/{id}`, change what you need and send the
whole object back, recipients included.
- `condition` is replaced as a whole: send every field the new condition needs.
- An object sent as `null` is left as it is. Settings that cannot be expressed with these fields
are returned as `null` and stay unchanged as long as you do not send them.
- `status` activates or disables the rule.
- A rule saved without any frequency is shown with both `schedule.instant` and `schedule.daily`
on, and is saved that way at its first update, so it starts sending alerts.
- A body with nothing to change returns `422`.
Options your plan does not include are refused with `402` when you switch them on or change
them; options the rule already uses keep working as long as you do not change them (see Plan
limits). Part of the Pricefy REST API.
Authentication: send the X-Api-Key header on every request. Base URL: https://api.pricefy.io.
OpenAPI specification ·
llms.txt ·
llms-full.txt
Merchant account, subscription and plan limits.
Store information and last import.
Merchant product catalog. Cursor-based pagination.
Competitor domains with price analysis.
URLs being monitored on each competitor, with stock and price diff.
Minimum Advertised Price rules and the resellers that breach them.
Dynamic pricing rules — create, read and update them, preview the suggested prices and apply them.
Scheduled reports — create, read and update them.
Alert rules (create, read and update them) and triggered alerts (price/stock variations).
The users of your account — invite colleagues, choose what each of them can see, suspend or remove them.
**Model Context Protocol** — same Pricefy API, exposed as MCP tools so Claude Desktop, Cursor, ChatGPT, Codex and the Claude CLI can call it natively. Streamable HTTP transport, JSON-RPC 2.0, dual auth (`X-Api-Key` **or** OAuth 2.1 Bearer), same per-merchant permissions as REST. 43 tools (26 read-only + 14 write + 3 destructive). See `POST /mcp` for the full catalog and the landing page for connection guides.
<img src="https://voyager.postman.com/logo/postman-logo-icon-orange.svg" alt="Postman" width="48" align="left" style="margin-right:12px"/>
The **complete Pricefy API collection** lives in the [public Pricefy Postman workspace](https://www.postman.com/pricefy/workspace/pricefy-api) — every endpoint, request body, query parameter and response example, pre-wired and ready to send. Use it to explore the API in Postman desktop / web, fork it into your own workspace, or run it as part of an automated test suite via Newman.
[](https://www.postman.com/pricefy/workspace/pricefy-api)
Alternatives:
- [Browse the workspace](https://www.postman.com/pricefy/workspace/pricefy-api) directly on postman.com
- [Download the collection JSON](/postman/collection.json) and import manually into Postman or Newman
