Skip to main content
POST
Move alert rules to folder

Restrictions

Usage

  • dest_folder_id must be an existing folder that the caller must be able to manage the folder (account owner or admin, creator of the folder or one of its ancestors, or member of the team bound to the folder or an ancestor); otherwise the whole call fails with AccessDenied and nothing is moved.
  • The result has one entry per requested ID, in request order. A moved rule’s message is a localized success text (Move successfully / 移动成功); a rule that is not moved stays in its folder and its message carries the error.
  • A rule is not moved when a rule with the same name already exists in the destination folder, when the caller cannot manage its current folder, or when the ID does not exist (its name is then id: <id>).
  • Every call is recorded in the account audit log. Don’t put secrets in request fields.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json
ids
integer<uint64>[]
required

IDs of the rules to move; must contain 1 to 100 IDs.

Required array length: 1 - 100 elements
dest_folder_id
integer<uint64>
required

Destination folder ID, from POST /monit/folder/list. Must be non-zero; a folder that does not exist or that the caller cannot manage fails the whole call with AccessDenied.

Response

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[]

Per-rule batch-operation results.