v1

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

A new subdomain is added to the given domain.

A new subdomain is added to the given company's 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 Subdomain' article in the Black Kite help documents.

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

Path parameters

idinteger required
Example:123

The id of the company to be updated.

Request body

Domainstring required

The domain for which a subdomain wanted to be added.

Subdomainstring required

The subdomain to be added.

Example request

{
  "Domain": "acmeinc.com",
  "Subdomain": "nasa.acmeinc.com"
}

Response

Success