Skip to main content
PUT
/
api
/
v1
/
rules:batchUpdate
BatchUpdateRules
curl --request PUT \
  --url https://api.siftstack.com/api/v1/rules:batchUpdate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rules": [
    {
      "name": "<string>",
      "description": "<string>",
      "conditions": [
        {
          "expression": {},
          "actions": [
            {
              "actionType": "ACTION_KIND_UNSPECIFIED",
              "configuration": {},
              "ruleActionId": "<string>"
            }
          ],
          "ruleConditionId": "<string>"
        }
      ],
      "metadata": [
        {
          "key": {
            "name": "<string>",
            "type": "METADATA_KEY_TYPE_UNSPECIFIED",
            "archivedDate": "2023-11-07T05:31:56Z"
          },
          "stringValue": "<string>",
          "numberValue": 123,
          "booleanValue": true,
          "archivedDate": "2023-11-07T05:31:56Z"
        }
      ],
      "ruleId": "<string>",
      "assetId": "<string>",
      "isEnabled": true,
      "organizationId": "<string>",
      "versionNotes": "<string>",
      "clientKey": "<string>",
      "assetConfiguration": {
        "assetIds": [
          "<string>"
        ],
        "tagIds": [
          "<string>"
        ]
      },
      "isExternal": true
    }
  ],
  "overrideExpressionValidation": true,
  "validateOnly": true
}
'
{
  "success": true,
  "rulesCreatedCount": 123,
  "rulesUpdatedCount": 123,
  "validateOnly": true,
  "validationResults": [
    {
      "assetExpressionValidationResults": [
        {
          "assetId": "<string>",
          "assetName": "<string>",
          "assetTagId": "<string>",
          "error": "<string>"
        }
      ],
      "ruleId": "<string>",
      "clientKey": "<string>",
      "error": "<string>"
    }
  ],
  "createdRuleIdentifiers": [
    {
      "ruleId": "<string>",
      "name": "<string>",
      "clientKey": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.siftstack.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
rules
rules are limited 1000 rules at a time · object[]
required
​
overrideExpressionValidation
boolean
required

If override_expression_validation is true, the request will save the rules even if the expressions are invalid. This can be useful for multi-asset rules where an invalid expression for one asset should not prevent the rule from being saved.

​
validateOnly
boolean

If validate_only is true, the request will only validate the request and not save the rules.

Response

A successful response.

​
success
boolean
required
​
rulesCreatedCount
integer<int32>
required

The total number of rules created in the request. If validate_only is true, this will indicate how many rules would have been created.

​
rulesUpdatedCount
integer<int32>
required

The total number of rules updated in the request. If validate_only is true, this will indicate how many rules would have been updated.

​
validateOnly
boolean
required

This will be true if the request only validated the request and did not save the rules.

​
validationResults
One ValidationResult per rule in the request will be returned · object[]
required
​
createdRuleIdentifiers
object[]
required

The created rule id, name, version, and client key.