Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

POST: Set an End Date for Company-Provided Infrastructure

Avatar
Ingrid
Follow
Publication Date – May 4, 2021

⇤ Companies

https://api.bitsighttech.com/ratings/v1/companies/infrastructure/expiration

Set an end date for company-provided infrastructure. The removal of company-provided infrastructure takes 1-2 days to process. This change will affect your rating if there are any associated findings.

Learn more about infrastructure management.

Only Admin or Group Admin can set an end date for company-provided infrastructure. See user permissions.

Parameters

*Required.

Parameter Description Values 
infrastructure_type
Data		 Identify the type of infrastructure. [String] cidr 
expirations
Data		 Infrastructure to set an end date. [Array] Comma-separated infrastructure objects.
Limit: 50 objects.
  
company
Data		 Identify the company attributed to the infrastructure. [String] Company unique identifier [entity_guid]. See GET: Ratings Tree. 
infrastructure
Data		 Identify the infrastructure. [String] The IP address or CIDR. 
end_date
Data		 The date to set as the end date. [String] The end date [YYYY-MM-DD], which could be any day from 2011-01-01 (the start of the Bitsight platform) through “today.” Future dates are not permitted.
Default: Date of request (today).

Example Request

cURL:

curl -X POST --data-ascii '{
  "infrastructure_type": "cidr",
  "expirations": [
    {
      "company": "a940bb61-33c4-42c9-9231-c8194c305db3",
      "infrastructure": "12.3.456.7/20",
      "end_date": "2020-01-01"
    }
  ]
}' https://api.bitsighttech.com/ratings/v1/companies/infrastructure/expiration -u api_token: --header "Content-Type:application/json"

JSON:

{
  "infrastructure_type": "cidr",
  "expirations": [
    {
      "company": "a940bb61-33c4-42c9-9231-c8194c305db3",
      "infrastructure": "12.3.456.7/20",
      "end_date": "2020-01-01"
    }
  ]
}

Response Codes

See the common errors and status codes.

Code Description
201 End date request successfully submitted.
400 Bad data.
401 Unauthorized.
403 You do not have control over the infrastructure and are not permitted to modify it.
404 The specified resource was not found.

Related articles