https://api.bitsighttech.com/ratings/v1/companies/company_guid/infrastructure/custom/bulk/
Delete one or more assets from a company's custom infrastructure and no longer be attributed to them.
Parameters
* Required.
delete-
* Required.
[Body] Identify custom Infrastructure to delete.
Value: [Object] Custom Infrastructure objects, separated by
cidrsanddomains. -
delete:cidrs -
[Data] Identify infrastructure to delete by CIDR block.
Value: [Object]
value -
cidrs:value -
* Required for the
cidrsparameter.[Data] Identify CIDR blocks to delete.
Value: [String] CIDR name.
-
delete:domains -
[Data] Identify infrastructure to delete by domains.
Value: [Object]
value -
domains:value -
* Required for the domains parameter.
[Data] Identify domains to delete.
Value: [String] IP name.
guid-
* Required.
[Path] Identify the company to modify.
Value: [String] Company unique identifier [
entity_guid]. See GET: Portfolio Details.
Example Request
curl -X POST --data-ascii '{
"delete": {
"cidrs": [
{
"value": "12.3.456.7/20",
"value": "23.4.678.7/20"
}
],
"domains": [
{
"value": "sub.domain.tld"
}
]
}
}' https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure/custom/bulk -u api_token: --header "Content-Type:application/json"Example Response
{
"deleted": {
"domains": [
{
"value": "sub.domain.tld"
}
],
"cidrs": [
{
"value": "12.3.456.7/20"
}
]
},
"not_deleted": {
{
"value": "23.4.678.7/20",
"message": "CIDR does not exist",
}
}
}Response Attributes
| Field | Description | |||
|---|---|---|---|---|
deleted Object |
Assets that were deleted. | |||
domains Array |
Domains that were deleted. | |||
| Object | A domain and its details. | |||
value String |
The domain name. | |||
cidrs Array |
CIDR blocks that were deleted. | |||
| Object | A CIDR block and its details. | |||
value String |
CIDR block name. | |||
not_deleted Object |
Assets that were not deleted and reasons why they could not be deleted. | |||
| Object | The asset and the reason why it could not be deleted. | |||
value String |
The asset name (IP/CIDR or domain). | |||
message String |
The reason why the asset could not be deleted. | |||
- July 17, 2025: Published.
Feedback
0 comments
Please sign in to leave a comment.