Deletes the company with the specified id. | awork API

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>

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

Required Permissions

The user must be an admin or have company-master-data:write permissions.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

companyIdstringRequiredformat: "uuid"

The id of the company.

Request

The model describing how to delete the company.

moveToCompanystring or nullOptionalformat: "uuid"

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’.

deleteOperationstring or nullOptional

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

No Content

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Required Permissions

The user must be an admin or have company-master-data:write permissions.

Bearer authentication of the form Bearer <token>, where token is your auth token.

The id of the company.

The model describing how to delete the company.

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’.

$	curl -X POST https://api.awork.com/api/v1/companies/companyId/delete \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"deleteOperation": "delete-only-company"
>	}'

$	curl -X POST https://api.awork.com/api/v1/companies/companyId/delete \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"deleteOperation": "delete-only-company"
>	}'