Skip to main content
DELETE
Remove a company from a monitor
New hire monitoring requires a V2 workspace API key. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.
Remove one company by its identifier, the lower-case company slug or numeric ID from its URL as returned in the monitor’s companies. The response returns the updated monitor, the removed company, and baseline_reset: true.
Removing a company restarts the baseline. The monitor discards undelivered findings, cancels an in-progress check, and rebuilds its baseline on the next check. New hires already delivered and the results table are kept.
A company-list monitor keeps at least one company: removing the last one returns 422 last_company. An identifier the monitor does not watch returns 404 company_not_found. Market and legacy monitors return 422 market_monitor_has_no_companies and 422 legacy_monitor.

Next step

Use Add companies to replace a removed company.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Path Parameters

monitor_id
string<uuid>
required
identifier
string
required

The company's identifier from the monitor's company list: the lower-case company slug or numeric company ID from its LinkedIn URL.

Pattern: ^[A-Za-z0-9_-]{1,200}$

Response

The monitor after the removal and the removed company.

monitor
object
required
company
object
required
baseline_reset
boolean
required