Batch update rule fields

Update specific fields across multiple alert rules at once. Only the fields listed in fields are applied.

POST /monit/rule/update/fields

Batch update rule fields

cURL

curl --request POST \
  --url 'https://api.flashcat.cloud/monit/rule/update/fields?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    50001,
    50002
  ],
  "fields": [
    "enabled"
  ],
  "enabled": false
}
'

200

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": [
    {
      "name": "CPU High",
      "message": ""
    },
    {
      "name": "Disk High",
      "message": ""
    }
  ]
}

Restrictions

Aspect	Value
Rate limits	1,000 requests/minute; 50 requests/second per account
Permissions	Alerting Rules Manage (monit)

Usage

• Include the field names you want to update in the fields array, e.g. ["enabled", "channel_ids"].
• Only the specified fields are updated; others are left unchanged.
• Every call is recorded in the account audit log. Don’t put secrets in request fields.

Authorizations

app_key · string · query · required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

ids · integer<uint64>[] · required

Rule IDs to update.

fields · string[] · required

Field names to update.

labels · object

Show child attributes

ds_type · string

ds_list · string[]

ds_ids · integer<uint64>[]

enabled · boolean

debug_log_enabled · boolean

cron_pattern · string

timezone · string · default: Asia/Shanghai

Timezone in which the rule executes. IANA timezone name; defaults to Asia/Shanghai.

delay_seconds · integer

enabled_times · object[]

Show child attributes

annotations · object

Show child attributes

description · string

channel_ids · integer<uint64>[]

repeat_interval · integer<int64>

repeat_total · integer<int64>

Response

200

application/json

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id · string · required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data · object[] · required

Per-rule batch-operation results.

Show child attributes