Delete a company

DELETE 
/api/v1/companies/:id

Delete a company by ID.

Authorization is based on the OAuth application's tenant access to the company's workspace.

Important: Companies with existing subsidiaries cannot be deleted. You must first delete or reassign all subsidiaries before deleting the parent company.

Request

Responses

204

The company was deleted. The response body is empty.

401

The request is missing a bearer token, or the token is invalid or expired.

404

The company does not exist, or it belongs to a workspace the OAuth application cannot access.

422

The company has subsidiaries and cannot be deleted; delete or reassign the subsidiaries first.