PATCH /asset_model/assets

Edit online

Perform bulk asset CREATE and/or DELETE operations asynchronously.

Patches an array of assets. Capable of creating and deleting multiple assets in the same request. 1. Create - If an asset has no id parameter specified, the operation is assumed to be CREATE. 2. Delete - If an asset has an id parameter specified, and the 'deleted' parameter is true, the operation is assumed to be DELETE. An asset contains the following fields:
  • id - Long - The ID of the asset. Omit or set to null for CREATE; provide the existing asset ID for DELETE.
  • deleted - Boolean - Set to 'true' to mark the asset for deletion. Required when 'id' is provided. Ignored for CREATE operations.
  • interfaces - Array - The interfaces on this asset, only one interface is accepted.
  • mac_address - String - The MAC address of this interface.
  • ip_address - Array - Interface is allowed a maximum of two IP addresses, whether IPv4 or IPv6, with no provision for more than two addresses.
  • value - String - The IP address for this asset is required. At least one valid IP address must be configured.
  • domain_id - Integer - The domain ID for this asset. Optional if user has access to only one domain.
  • products - Array - The products on this asset. Each asset must have at least one value specified for the product name, vendor, and version.
  • name - String - Product name of this asset.
  • version - String - Product version of this asset.
  • vendor - String - Product vendor of this asset.
  • hostnames - Array - The hostnames on this asset. Asset may be assigned no more than two hostnames.
  • name - String - Name of hostname on this asset. The hostname for each asset must be limited to a maximum of 255 characters.
  • type - String - Type of hostname on this asset. Type must be either DNS or NETBIOS and can be added once.
  • properties - Array - The properties on this asset.
  • type_id - Long - The property type ID.
  • value - String - Value of property on this asset.
Table 1. PATCH /asset_model/assets resource details
MIME Type

text/plain

Table 2. PATCH /asset_model/assets request body details
Parameter Data Type MIME Type Description Sample

assets

JSON

application/json

Required. The list of asset objects to process.

[ { "interfaces": [ { "mac_address": "00:14:22:01:23:44", "ip_addresses": [ { "value": "10.1.1.24" }, { "value": "10.1.1.25" } ] } ], "domain_id": 1, "hostnames": [ { "name": "dns.host.test", "type": "DNS" }, { "name": "netbios.host", "type": "NETBIOS" } ], "products": [ { "name": "Windows 95", "vendor": "Microsoft", "version": "0.0" } ], "properties": [ { "type_id": 1002, "value": "business value" } ] }, { "id": 1001, "deleted": true } ]
Table 3. PATCH /asset_model/assets response codes
HTTP Response Code Unique Code Description

202

With a location header to an asset bulk task resource.

422

1001

The 'assets' request body is null or empty.

422

1002

The number of assets in the request exceeds the maximum limit.

429

1003

The user has sent too many requests in a given amount of time.

500

1004

An error occurred during the attempt to create the bulk asset task.

Response Description

Response Sample