Creates or updates an asset with the specified details.
External DocumentationTo learn more, visit the Rapid7 documentation.

​
Parameters

ParameterDescription
AddressesAll 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 DateThe date the data was collected on the asset.
ConfigurationsConfiguration key-values pairs enumerated on the asset.
For example:
[
  {
    “name”: “First Configuration”,
    “value”: “The value 1”
  },
  {
    “name”: “Second Configuration”,
    “value”: “The value 2”
  }
]
DescriptionThe 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 EnforcementEnable 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 NameThe host name (local or FQDN).
Host Name SourceThe source used to detect the host name. user indicates the host name source is user-supplied (e.g. in a site target definition).
IPThe primary IPv4 or IPv6 address of the asset.
Site IDThe ID of the site.
TypeThe type of asset.

​
Example Output

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

​
Workflow Library Example

Create or Update Asset with Rapid7 and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop