Delete item defaultDimensions

Deletes the default dimensions of the item 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})/items({itemId})/defaultDimensions({itemId},{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 items, the items 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 item and corresponding dimension.



Here is an example of the request.

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


No Content.

See also

Tips for working with the APIs

Create item defaultDimensions
Update item defaultDimensions
Get item defaultDimensions