v1

latestOpenAPI 3.0.0Proprietary - Commercial Use Only2026-08-06172139621.6 KB
Company Digital Footprint

A new secondary top level domain (TLD) is added to the given company.

A new TLD domain is added to the given company as a secondary domain and a scan is triggered if it's classified as active. When Black Kite starts to monitor your companies, it scrapes all the related domains, which is called the digital footprint of that company. However, albeit rare, there are cases where you may want to relate a seemingly unrelated domain with your company, such as a side domain. Certain roles or permissions are needed to be able to use this endpoint. See the Extensions section of this endpoint or take a look at the 'Adding a Domain' article in the Black Kite help documents.

post/api/v2/companies/{id}/domains

Path parameters

idinteger required
Example:123

The id of the company to be updated.

Request body

Domainstring required

The domain to be added. Make sure that the domain value here is a TLD domain.

Importance'Low' | 'Medium' | 'High' | 'Critical' | 'Urgent'

Use to prioritizing the scan order of the domain. A domain’s importance level is simply a tag subscribed to a TLD. Urgent indicates that the domain is of the highest priority and should be scanned first, where domains tagged as Low are scanned last. Medium is used as a default when left out in the request.

Example request

{
  "Domain": "acmeincsupport.com",
  "Importance": "medium"
}

Response

Success