Asset Bulk Action

post

https://{dc-region}.zuperpro.com/api/assets/bulk_action

Performs a bulk operation on assets. You must scope the action with at least one of asset_uid, filter, or filter_rules — if none are provided, the action applies to every asset in your company, including destructive actions like delete_assets.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

action

string

enum

required

Note: activate and deactivate are both handled by the same underlying logic. The actual effect is driven entirely by action_options.is_active (boolean) — sending action: "activate" with action_options.is_active: false will deactivate the matched assets.

Allowed:

asset_uid

array of strings

Array of asset UIDs to target. Note the field name is singular (asset_uid) even though it holds a list — asset_uids is not recognized and will be silently ignored, causing the action to fall back to matching all assets. Optional if filter or filter_rules is provided instead.

asset_uid

filter_rules

array

Advanced rule-engine filter, used as an alternative to asset_uid/filter. Each entry is a condition object (e.g. {"field": "asset_uid", "operator": "IN", "value": ["..."]}). When present and non-empty, this takes precedence and the request is evaluated via the rule engine.

filter_rules

filter_rule_operator

string

enum

Defaults to AND

How multiple filter_rules entries are combined. Defaults to AND.

Allowed:

Responses

200200

400400

404Not Found