How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Rapid7 Asset API

Resources and operations for managing assets. Assets can be created under the Site Assets resource.

Rapid7 Asset API is one of 50 APIs that Rapid7 publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Asset. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 25 operations across 23 paths, and defines 47 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against a single base URL, https://[region].api.insight.rapid7.com/ias/v1.

25 operations 23 paths 47 schemas 2 DELETE20 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://us.api.insight.rapid7.com/vm/v4
Resource Areas
1

Paths & Operations 25

Across 23 paths, the API surfaces 25 operations — 2 DELETE, 20 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Asset 25

Resources and operations for managing assets. Assets can be created under the Site Assets resource.

GET
/api/3/assets
Assets
getAssets 3 params → 200401404500503
POST
/api/3/sites/{id}/assets
Assets
createAsset 2 params → 200201400401500503
POST
/api/3/assets/search
Asset Search
findAssets 4 params → 200400401500503
GET
/api/3/assets/{id}
Asset
getAsset 1 param → 200401404500503
DELETE
/api/3/assets/{id}
Asset
deleteAsset 1 param → 200401404500503
GET
/api/3/assets/{id}/databases
Asset Databases
getAssetDatabases 1 param → 200401404500503
GET
/api/3/assets/{id}/files
Asset Files
getAssetFiles 1 param → 200401404500503
GET
/api/3/assets/{id}/services
Asset Services
getAssetServices 1 param → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}
Asset Service
getAssetService 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/configurations
Asset Service Configurations
getAssetServiceConfigurations 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/databases
Asset Service Databases
getAssetServiceDatabases 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/user_groups
Asset Service User Groups
getAssetServiceUserGroups 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/users
Asset Service Users
getAssetServiceUsers 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/web_applications
Asset Service Web Applications
getAssetServiceWebApplications 3 params → 200401404500503
GET
/api/3/assets/{id}/services/{protocol}/{port}/web_applications/{webApplicationId}
Asset Service Web Application
getAssetServiceWebApplication 4 params → 200401404500503
GET
/api/3/assets/{id}/software
Asset Software
getAssetSoftware 1 param → 200401404500503
GET
/api/3/assets/{id}/tags
Asset Tags
getAssetTags 1 param → 200401404500503
PUT
/api/3/assets/{id}/tags/{tagId}
Asset Tag
addAssetTag 2 params → 200400401404500503
DELETE
/api/3/assets/{id}/tags/{tagId}
Asset Tag
removeAssetTag 2 params → 200401404500503
GET
/api/3/assets/{id}/user_groups
Asset User Groups
getAssetUserGroups 1 param → 200401404500503
GET
/api/3/assets/{id}/users
Asset Users
getAssetUsers 1 param → 200401404500503
GET
/api/3/operating_systems
Operating Systems
getOperatingSystems 3 params → 200401404500503
GET
/api/3/operating_systems/{id}
Operating System
getOperatingSystem 1 param → 200401404500503
GET
/api/3/software
Software
getSoftwares 3 params → 200401404500503
GET
/api/3/software/{id}
Software
getSoftware 1 param → 200401404500503

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are AssetCreate (27 properties), Asset (24 properties), SoftwareCpe (13 properties), OperatingSystemCpe (13 properties). Each schema is shown below with its type and property counts.

WebPage
object
3 properties
ServiceLink
object
4 properties
PageInfo
object
4 properties
Configuration
object
2 properties 1 required
BadRequestError
object
3 properties 1 required
AssetCreate
object
27 properties 1 required
Address
object
2 properties
UniqueId
object
2 properties 1 required
ReferencesWith«ReferenceWithEndpointIDLink,ServiceLink»
object
2 properties
InternalServerError
object
3 properties 1 required
SearchCriteria
object
2 properties
SwaggerSearchCriteriaFilter
object
6 properties
UnauthorizedError
object
3 properties 1 required
Software
object
9 properties
Resources«AssetTag»
object
2 properties
UserAccount
object
3 properties
Database
object
3 properties 1 required
AssetVulnerabilities
object
6 properties
ReferencesWith«WebApplicationID,Link»
object
2 properties
HostName
object
2 properties 1 required
NotFoundError
object
3 properties 1 required
File
object
4 properties 2 required
PageOf«OperatingSystem»
object
3 properties
Resources«File»
object
2 properties
Links
object
1 property
Asset
object
24 properties
OperatingSystem
object
11 properties
PageOf«Software»
object
3 properties
Resources«UserAccount»
object
2 properties
Link
object
2 properties
ReferenceWithEndpointIDLink
object
3 properties
ServiceUnavailableError
object
3 properties 1 required
CreatedOrUpdatedReference
object
2 properties
TagAssetSource
object
3 properties
AssetTag
object
10 properties 2 required
SoftwareCpe
object
13 properties 1 required
Resources«Software»
object
2 properties
CreatedReference
object
2 properties
GroupAccount
object
2 properties 1 required
WebApplication
object
4 properties
OperatingSystemCpe
object
13 properties 1 required
PageOf«Asset»
object
3 properties
Resources«GroupAccount»
object
2 properties
Resources«Database»
object
2 properties
Service
object
13 properties 2 required
AssetHistory
object
7 properties
Resources«Configuration»
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rapid7-asset-api-openapi.yml Raw ↑

Other APIs Rapid7 publishes across the network.

Rapid7 InsightVM Cloud API
Rapid7 Insight Platform API
Rapid7 InsightIDR API
Rapid7 Accounts API
Rapid7 Administration API
Rapid7 Apps API
Rapid7 Asset Discovery API
Rapid7 Asset Group API
Rapid7 Assets API
Rapid7 Attachments API
Rapid7 Attack Templates API
Rapid7 Blackouts API
Where this information came from

This is an independent, third-party profile of Rapid7 Asset API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.