v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-142013116.2 KB
Documents

Delete document

Deletes a document.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:

ProductCategoryResource
Dynamic StorageDynamic storage generic resourcesFull access to all documents
Dynamic StorageDynamic storage generic resourcesMaster Data administrator

There are no applicable predefined roles for this resource list. You must create a custom role and add at least one of the resources above in order to use this endpoint.To learn more about machine authentication at VTEX, see Authentication overview.

❗ To prevent integrations from having excessive permissions, consider the best practices for managing API keys when assigning License Manager roles to integrations.

delete/api/dataentities/{dataEntityName}/documents/{id}

Path parameters

dataEntityNamestring required
Example:Newsletter

Name of the data entity.

idstring required
Example:b818cbda-e489-11e6-94f4-0ac138d2d42e

ID of the Document.

Headers

Content-Typestring required
Example:application/json

Type of the content being sent.

Acceptstring required
Example:application/json

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Response

No Content