Bulk Update Assets
PUT https://{{API_URL}}/assets/bulk
Update multiple assets at a time using the bulk update endpoint. Update limit is 30,000 assets at a time.
By default we will index the assets in the background. In order to index your assets synchronously pass in the realtime parameter and set it to true.
In addition to the standard attributes on the asset
parameter, you can also provide a remove_tags
params: an array of strings that represent tags you would like removed, and a reset_tags
param: a boolean value set to true if you would like to completely clear tags for each asset.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
**All parms below updated in Body | string | **All parms updated in Body | |
asset_ids | string | array of integers - Kenna ids found in URL of asset when selected | |
Asset | string | ||
inactive | string | boolean | |
A boolean value to set the asset inactive | |||
ipv6 | string | string | |
The asset's ipv6 address | |||
last_booted_at | string | string | |
A datetime (as an iso8601 timestamp) identifying when the asset was last booted |
|
| last_seen_time
| string | | string - A datetime (as an iso8601 timestamp) identifying when the asset was last seen |
| notes
| string | | string
Strings may be used to store plain english notes about an asset
|
| operating_system
| string | | string
The operating system of the asset |
| owner
| string | | string
The name of the owner of an asset. |
| priority
| string | | int32
The priority of the asset; an integer between 1 (low) to 10 (high) |
| reset_tags
| string | | Boolean - reset tags? |
| remove_tags
| string | | array of strings- specify which ones to remove |
| tags
| string | | array of strings - add tags |
| realtime
| string | | Boolean - determines if indexing is required in real time or background |
Request Body
{"asset"=>{"priority"=>"", "notes"=>"", "created_at"=>"", "operating_system"=>"", "last_booted_at"=>"", "ipv6"=>"", "inactive"=>"", "owner"=>"", "reset_tags"=>"", "last_seen_time"=>""}, "asset_ids"=>["<integer>", "<integer>"], "realtime"=>"<boolean>"}