Delete a dataflow using the Flow Service API

You can delete batch and streaming dataflows that contain errors or have become obsolete using the Flow Service API.

This tutorial covers the steps for deleting dataflows made with both batch and streaming sources using Flow Service.

Getting started

This tutorial requires you to have a valid flow ID. If you do not have a valid flow ID, select your connector of choice from the sources overview and follow the steps outlined before attempting this tutorial.

This tutorial also requires you to have a working understanding of the following components of Adobe Experience Platform:

  • Sources: Experience Platform allows data to be ingested from various sources while providing you with the ability to structure, label, and enhance incoming data using Platform services.
  • Sandboxes: Experience Platform provides virtual sandboxes which partition a single Platform instance into separate virtual environments to help develop and evolve digital experience applications.

Using Platform APIs

For information on how to successfully make calls to Platform APIs, see the guide on getting started with Platform APIs.

Delete a dataflow

With an existing flow ID, you can delete a dataflow by performing a DELETE request to the Flow Service API.

API format

DELETE /flows/{FLOW_ID}
Parameter
Description
{FLOW_ID}
The unique id value for the dataflow you want to delete.

Request

curl -X DELETE \
    'https://platform.adobe.io/data/foundation/flowservice/flows/20c115bc-46e3-40f3-bfe9-fb25abe4ba76' \
    -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}'

Response

A successful response returns HTTP status 204 (No Content) and a blank body. You can confirm the deletion by attempting a lookup (GET) request to the dataflow. The API will return an HTTP 404 (Not Found) error, indicating that the dataflow has been deleted.

Next steps

By following this tutorial, you have successfully used the Flow Service API to to delete an existing dataflow.

For steps on how to perform these operations using the user interface, please refer to the tutorial on deleting dataflows in the UI

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089