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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Rapid7

Rapid7 Asset Group API

Resources and operations for managing asset groups.

Documentation Provider Profile APIs.io OpenAPI GitHub

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 v1.

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

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
v1
Base URL
https://us.api.insight.rapid7.com/vm/v4
Resource Areas
1

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 1 param → 201400401500503
GET
/api/3/asset_groups/{id}
Asset Group
getAssetGroup 1 param → 200401404500503
PUT
/api/3/asset_groups/{id}
Asset Group
updateAssetGroup 2 params → 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 2 params → 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 2 params → 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 2 params → 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 2 params → 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), OperatingSystemCpe (13 properties), Service (13 properties). Each schema is shown below with its type and property counts.

WebPage
object
3 properties
PageInfo
object
4 properties
Configuration
object
2 properties 1 required
BadRequestError
object
3 properties 1 required
Agent
object
26 properties 1 required
ReferencesWith«TagID,Link»
object
2 properties
Address
object
2 properties
UniqueId
object
2 properties 1 required
AssetGroup
object
9 properties 2 required
InternalServerError
object
3 properties 1 required
PageOf«AssetGroup»
object
3 properties
ReferencesWith«UserID,Link»
object
2 properties
SearchCriteria
object
2 properties
SwaggerSearchCriteriaFilter
object
6 properties
ReferencesWith«AssetID,Link»
object
2 properties
UnauthorizedError
object
3 properties 1 required
Software
object
9 properties
UserAccount
object
3 properties
Database
object
3 properties 1 required
AssetVulnerabilities
object
6 properties
HostName
object
2 properties 1 required
NotFoundError
object
3 properties 1 required
File
object
4 properties 2 required
Links
object
1 property
OperatingSystem
object
11 properties
CreatedReference«AssetGroupID,Link»
object
2 properties
PageOf«Agent»
object
3 properties
Link
object
2 properties
ServiceUnavailableError
object
3 properties 1 required
SoftwareCpe
object
13 properties 1 required
GroupAccount
object
2 properties 1 required
WebApplication
object
4 properties
OperatingSystemCpe
object
13 properties 1 required
Vulnerabilities
object
4 properties
Service
object
13 properties 2 required
AssetHistory
object
7 properties

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
AE Profile APIs.io
Rapid7 Insight Platform API
AE Profile APIs.io
Rapid7 InsightIDR API
AE Profile APIs.io
Rapid7 Accounts API
AE Profile APIs.io
Rapid7 Administration API
AE Profile APIs.io
Rapid7 Apps API
AE Profile APIs.io
Rapid7 Asset API
AE Profile APIs.io
Rapid7 Asset Discovery API
AE Profile APIs.io
Rapid7 Assets API
AE Profile APIs.io
Rapid7 Attachments API
AE Profile APIs.io
Rapid7 Attack Templates API
AE Profile APIs.io
Rapid7 Blackouts API
AE Profile APIs.io
#Asset Group
← Back to R APIs
API Details
ID
rapid7:rapid7-asset-group-api
Base URL
https://us.api.insight.rapid7.com/vm/v4
Docs
https://help.rapid7.com/insightvm/en-us/api/api.html
Provider
Rapid7
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=rapid7-asset-group-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/rapid7-asset-group-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

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.