POST: Set an End Date for Company-Provided Assets – Bitsight Knowledge Base

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.

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

Parameters

* Required.

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

January 3, 2025: Linked to permissions.
May 4, 2021: Published.

Parameters

Example Request

Response Codes

Related articles