POST: Set an End Date for Company-Provided Assets

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

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

Learn more about infrastructure management.

Parameters

* Required.

infrastructure_type

[Data] Identify the type of infrastructure.

Value: [String] cidr

expirations

[Data] Infrastructure to set an end date.

Value: [Array] Comma-separated infrastructure objects.

Limit: 50 objects.

company

* Required.

[Data] Identify the company attributed to the infrastructure.

Value: [String] Company unique identifier [entity_guid]. See GET: Ratings Tree.

infrastructure

* Required.

[Data] Identify the infrastructure.

Value: [String] The IP address or CIDR.

end_date

[Data] The date to set as the end date.

Value: [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.

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.