Delete an object in the API

You can delete a Catalog object by providing its ID in the path of a DELETE request.


Take extra care when deleting objects, as this cannot be undone and may produce breaking changes elsewhere in Experience Platform.

API format


The DELETE /batches/{ID} endpoint has been deprecated. In order to delete a batch, you should be using the Batch Ingestion API.

Parameter Description
{OBJECT_TYPE} The type of Catalog object to be deleted. Valid objects are:
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} The identifier of the specific object you want to update.


The following request deletes a dataset whose ID is specified in the request path.

curl -X DELETE \
  '' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'


A successful response returns HTTP status 200 (OK) and an array containing the ID of the deleted dataset. This ID should match the one sent in the DELETE request. Performing a GET request on the deleted object returns HTTP status 404 (Not Found), confirming that the dataset has been deleted successfully.


If no Catalog objects match the ID provided in your request, you may still receive an HTTP Status Code 200, but the response array will be empty.

On this page