---
title: "Starts monitoring an already-known Black Kite company (e.g. found via global search) by its Black Kite Id."
method: POST
path: "/api/v2/companies/{id}"
tags: ["Company"]
---

# Starts monitoring an already-known Black Kite company (e.g. found via global search) by its Black Kite Id.

`POST /api/v2/companies/{id}`

Attaches an existing Black Kite company, identified by its Black Kite Id, to one of the caller's own ecosystems and starts a continuous scan and monitoring process.

## Path parameters

- `id` integer, required

## Request body

- object
  - `EcosystemId` number, required — The identifier of the ecosystem that the company will be included in.
  - `LicenseType` 'ContinuousAnnual' | 'Continuous60day' | 'Inventory-only' — This parameter can get ContinuousAnnual or Continuous60day values, depending on which license you want to use for the company monitored. This field is optional and when left out, the system automatically utilizes an existing Continuous Annual license. In case there's none, an existing Continuous 60 Day license is used. When there are no valid continuous licenses, the system refuses to add that single company. Passing Inventory-only adds the company without consuming or requiring any active continuous license, tracked in the inventory but not fully monitored.

## Response `200`

Success

- object
  - `BlackKiteId` integer — The Black Kite Id of the company that is started to be monitored.
  - `DomainValue` string — The main domain value of the company that is started to be monitored.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — Not Found
- `default` — Failure

## Changes

- **2026-09-04** `d80d95cf2197` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/blackkitetech/apis/black-kite-api/changes/api/v2/companies/:id/post.md)

---

[API](https://skmtc.dev/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.dev/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blackkitetech/apis/black-kite-api/revisions/f1e937bdbbbd?raw)