---
title: "Deletes the company with the specified id."
method: POST
path: "/companies/{companyId}/delete"
tags: ["companies"]
---

# Deletes the company with the specified id.

`POST /companies/{companyId}/delete`

There are several ways to delete a company.
            Look into the property description of the post model to get detailed information.
            <br />If the post is executed without a model, the default process 'delete-only-company' will be executed.
            <br />For the operation 'delete-all-without-timeentries' project-master-data write permissions are required on all projects of the company.

<Check title="Required Permissions" icon="key">The user must be an admin or have `company-master-data:write` permissions.</Check>

## Path parameters

- `companyId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- CompanyDeleteForm
  - `moveToCompany` string, uuid, nullable — Moves all related objects to this company. Related projects and tasks (including their time entries) will be connected to this company. Have to set if 'DeleteOperation' contains 'move'.
  - `deleteOperation` string, nullable — Defines the operation to delete a company. Possible operations are 'move': Move related objects to another company. 'delete-only-company': Delete only the company. Related objects loose the company information. 'delete-all-without-timeentries': Delete all related objects apart from time entries. 'delete-all': Delete all.

## Response `204`

No Content

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/revisions/f784a53f60df/schema)