Delete employee defaultDimensions

Deletes the default dimensions of the employee in Dynamics 365 Business Central.

HTTP request

Replace the URL prefix for Dynamics 365 Business Central depending on environment following the guideline.

DELETE businesscentralPrefix/companies({companyId})/employees({employeeId})/defaultDimensions({employeeId},{dimensionId})

Request headers

Header Value
Authorization Bearer {token}. Required.
If-Match Required. When this request header is included and the eTag provided does not match the current tag on the employees, the employees will not be updated.

Request body

Do not supply a request body for this method.


If successful, this method returns a 204 No Content response code and it deletes the default dimensions for the employee and corresponding dimension.



Here is an example of the request.

DELETE https://{businesscentralPrefix}/api/v1.0/companies({companyId})/employees({employeeId})/defaultDimensions({employeeId},{dimensionId})


No Content.

See also

Tips for working with the APIs

Create employee defaultDimensions
Update employee defaultDimensions
Get employee defaultDimensions