Skip to main content
DELETE
/
v1
/
companies
/
:id
curl https://api.usertour.io/v1/companies/comp_123456789 \
-X DELETE \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

{
  "id": "comp_123456789",
  "object": "company",
  "deleted": true
}
This endpoint permanently deletes a company and its associated data. When a company is deleted:
  • All company memberships are automatically removed
  • The company’s attributes and relationships are permanently deleted
  • The operation cannot be reversed

​
Path parameters

​
id
string
The unique identifier of the company to delete. This should match the ID format used in your system (e.g., comp_123456789).

​
Response

Returns a confirmation object indicating the successful deletion of the company.
​
id
string
The unique identifier of the deleted company.
​
object
string
String representing the object’s type. Always set to "company".
​
deleted
boolean
Indicates the success of the deletion operation. Always true when the request succeeds.
curl https://api.usertour.io/v1/companies/comp_123456789 \
-X DELETE \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

{
  "id": "comp_123456789",
  "object": "company",
  "deleted": true
}