PATCH · alerts:write

Update alert

Update an alert rule the user can edit.

External side effects

REST

PATCH/api/v1/alerts/:alertId

curl "https://www.stalkr.ai/api/v1/alerts/:alertId" \
  --request PATCH \
  --header "Authorization: Bearer $STALKR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: unique-operation-key"

MCP

Tool name: update_alert

The MCP tool accepts the same input schema and returns the same structured { data, meta } result as REST.

Input

name

string

active

boolean

channels

array

Exactly one email channel; Stalkr delivers alerts only to the verified workspace owner

digest

object

filters

object

alertIdrequired

string

idempotencyKey

string

Unique key used to safely retry this write operation

Safe retries

Pass idempotencyKey to the MCP tool or Idempotency-Key to REST when retrying this write.

Authorization

Required scope: alerts:write.

Scope authorization is followed by resource authorization. Project operations check current membership and the minimum role required by the underlying workflow.

Related resources

REST conventions · MCP setup · Errors and limits