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

KeyDatatypeRequiredDescription
**All parms below updated in Bodystring**All parms updated in Body
asset_idsstringarray of integers - Kenna ids found in URL of asset when selected
Assetstring
inactivestringboolean
A boolean value to set the asset inactive
ipv6stringstring
The asset's ipv6 address
last_booted_atstringstring
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>"}