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 Group API

Resources and operations for managing asset groups.

Rapid7 Asset Group 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 Group. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 22 operations across 10 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 3.

Requests are made against a single base URL, https://localhost:3780/.

22 operations 10 paths 36 schemas 6 DELETE7 GET1 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3
Base URL
https://us.api.insight.rapid7.com/vm/v4
Authentication
HTTP Basic
Contact
Resource Areas
1

Authentication & Security 1

Rapid7 Asset Group API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (Basic).

Paths & Operations 22

Across 10 paths, the API surfaces 22 operations — 6 DELETE, 7 GET, 1 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

Asset Group 22

Resources and operations for managing asset groups.

GET
/api/3/agents
Agents
getAgents 3 params → 200401404500503
GET
/api/3/asset_groups
Asset Groups
getAssetGroups 5 params → 200401404500503
POST
/api/3/asset_groups
Asset Groups
createAssetGroup body → 201400401500503
GET
/api/3/asset_groups/{id}
Asset Group
getAssetGroup 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}
Asset Group
updateAssetGroup 1 param body → 200400401404500503
DELETE
/api/3/asset_groups/{id}
Asset Group
deleteAssetGroup 1 param → 200401404500503
GET
/api/3/asset_groups/{id}/assets
Asset Group Assets
getAssetGroupAssets 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/assets
Asset Group Assets
updateAssetGroupAssets 1 param body → 200400401404500503
DELETE
/api/3/asset_groups/{id}/assets
Asset Group Assets
removeAllAssetsFromAssetGroup 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/assets/{assetId}
Asset Group Asset
addAssetToAssetGroup 2 params → 200400401404500503
DELETE
/api/3/asset_groups/{id}/assets/{assetId}
Asset Group Asset
removeAssetFromAssetGroup 2 params → 200401404500503
GET
/api/3/asset_groups/{id}/search_criteria
Asset Group Search Criteria
getAssetGroupSearchCriteria 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/search_criteria
Asset Group Search Criteria
setAssetGroupSearchCriteria 1 param body → 200400401404500503
GET
/api/3/asset_groups/{id}/tags
Asset Group Tags
getAssetGroupTags 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/tags
Asset Group Tags
setAssetGroupTags 1 param body → 200400401404500503
DELETE
/api/3/asset_groups/{id}/tags
Asset Group Tags
removeAllAssetGroupTags 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/tags/{tagId}
Resources and operations for managing asset groups
addAssetGroupTag 2 params → 200400401404500503
DELETE
/api/3/asset_groups/{id}/tags/{tagId}
Resources and operations for managing asset groups
removeAssetGroupTag 2 params → 200401404500503
GET
/api/3/asset_groups/{id}/users
Asset Group Users
getAssetGroupUsers 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}/users
Asset Group Users
setAssetGroupUsers 1 param body → 200400401404500503
PUT
/api/3/asset_groups/{id}/users/{userId}
Asset Group User
addAssetGroupUser 2 params → 200400401404500503
DELETE
/api/3/asset_groups/{id}/users/{userId}
Asset Group User
removeAssetGroupUser 2 params → 200401404500503

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are Agent (26 properties), SoftwareCpe (13 properties), Service (13 properties), OperatingSystemCpe (13 properties). Each schema is shown below with its type and property counts.

SwaggerSearchCriteriaFilter
object
6 properties
PageOf_Agent
object
3 properties
Link
object
2 properties
Links
object
1 property
AssetGroup
object
9 properties 2 required
AssetVulnerabilities
object
6 properties
GroupAccount
object
2 properties 1 required
ReferencesWith_TagID_Link
object
2 properties
BadRequestError
object
3 properties 1 required
UniqueId
object
2 properties 1 required
Address
object
2 properties
Vulnerabilities
object
4 properties
HostName
object
2 properties 1 required
OperatingSystemCpe
object
13 properties 1 required
Service
object
13 properties 2 required
Software
object
9 properties
SoftwareCpe
object
13 properties 1 required
InternalServerError
object
3 properties 1 required
File
object
4 properties 2 required
ReferencesWith_AssetID_Link
object
2 properties
AssetHistory
object
7 properties
ServiceUnavailableError
object
3 properties 1 required
NotFoundError
object
3 properties 1 required
Agent
object
26 properties 1 required
CreatedReference_AssetGroupID_Link
object
2 properties
OperatingSystem
object
11 properties
UserAccount
object
3 properties
WebApplication
object
4 properties
SearchCriteria
object
2 properties
WebPage
object
3 properties
Configuration
object
2 properties 1 required
ReferencesWith_UserID_Link
object
2 properties
UnauthorizedError
object
3 properties 1 required
PageOf_AssetGroup
object
3 properties
PageInfo
object
4 properties
Database
object
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rapid7-asset-group-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 API
Rapid7 Asset Discovery 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 Group 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.