Create Or Update Asset

Creates or updates an asset with the specified details.

External Documentation

To learn more, visit the Rapid7 documentation.

​

Parameters

Parameter	Description
Addresses	All addresses discovered on the asset. For example: [ { “ip”: “123.245.34.235”, “mac”: “12:34:56:78:90:AB” }, { “ip”: “12.43.56.221”, “mac”: “12:34:A6:76:12:JH” } ]
Asset Data Collection Date	The date the data was collected on the asset.
Configurations	Configuration key-values pairs enumerated on the asset. For example: [ { “name”: “First Configuration”, “value”: “The value 1” }, { “name”: “Second Configuration”, “value”: “The value 2” } ]
Description	The description of the source or collection of information on the asset. This description will appear in the history of the asset for future auditing purposes.
Disable SSL Enforcement	Enable this option to skip SSL verification of the server’s certificate chain and host name. This may increase security vulnerabilities, but can be useful for testing or when custom verification is employed.
Host Name	The host name (local or FQDN).
Host Name Source	The source used to detect the host name. user indicates the host name source is user-supplied (e.g. in a site target definition).
IP	The primary IPv4 or IPv6 address of the asset.
Site ID	The ID of the site.
Type	The type of asset.

​

Example Output

{
	"id": "1",
	"links": [
		{
			"href": "https://hostname:3780/api/3/...",
			"rel": "self"
		}
	]
}