Show Menu

Delete an object

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 .
The type of Catalog object to be deleted. Valid objects are:
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
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: {IMS_ORG}' \
  -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.