Delete attachments

Deletes attachments in Business Central. An attachment in the Business Central API is defined as an Incoming Document (table 130).

HTTP request

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

DELETE businesscentralPrefix/companies({companyId})/attachments({attachmentId})

Request headers

Header Value
Authorization Bearer {token}. Required.
If-Match Required. When this request header is included and the eTag provided doesn't match the current tag on the attachment, the attachment won't be updated.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 204 No Content response code and it deletes the attachment.

Example

Request

Here's an example of the request.

DELETE https://{businesscentralPrefix}/api/v2.0/companies({companyId})/attachments({parentId},{attachmentId})

Response

Here's an example of the response.

HTTP/1.1 204 No Content

Tips for working with the APIs
attachment
Get attachment
Create attachment
Update attachment