---
updatedAt: 2026-06-24T17:31:32.000Z
agentTools:
  projectIndex: https://marketing.developer.dotdigital.com/llms.txt
---

# Delete configuration

Deletes a Data Firehose configuration. 
If data sync is in progress returns 409.

_Note: Once a configuration deleted it cannot be restored, this is a destructive call!_

<Callout icon="📘" theme="info">
  If data sync is in progress, the request returns `409`.
</Callout>

<br />

<Callout icon="❗️" theme="error">
  Once a configuration is deleted it **cannot be restored**. This is a destructive call.
</Callout>

<span class="callRateLow" />

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Data Firehose",
    "description": "**Note: This is in private preview and should not be used.**\n\nCreate, retrieve, update, and delete Data Firehose configurations. Use this\nAPI to define which events to stream, set the sync frequency, configure the\ntarget storage platform (Amazon S3, Azure Blob Storage, FTPS, SFTP, or\nGoogle Cloud Storage), and enable or disable a configuration.",
    "version": "3.0.1"
  },
  "servers": [
    {
      "url": "https://{region}-api.dotdigital.com",
      "variables": {
        "region": {
          "description": "The Dotdigital region id your account belongs to",
          "enum": [
            "r1",
            "r2",
            "r3"
          ],
          "default": "r1"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Data Firehose"
    }
  ],
  "paths": {
    "/data-firehose/v3/configurations/{id}": {
      "delete": {
        "tags": [
          "Data Firehose"
        ],
        "summary": "Delete configuration",
        "description": "Deletes a Data Firehose configuration. \nIf data sync is in progress returns 409.\n\n_Note: Once a configuration deleted it cannot be restored, this is a destructive call!_",
        "operationId": "deleteConfiguration",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The Data Firehose configuration id to delete",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1234"
          }
        ],
        "responses": {
          "204": {
            "description": "Configuration deleted successfully"
          },
          "400": {
            "description": "Bad request, you have an error in the request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Configuration not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errorResponse"
                },
                "example": {
                  "errorCode": "dataFirehose:configNotFound",
                  "description": "The Data Firehose configuration id `YOUR ID` was not found!"
                }
              }
            }
          },
          "409": {
            "description": "Cannot delete data sync in progress",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errorResponse"
                },
                "example": {
                  "errorCode": "dataFirehose:syncInProgress",
                  "description": "The Data Firehose configuration is currently syncing so cannot be deleted."
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [
          {
            "basicAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "errorResponse": {
        "required": [
          "description",
          "errorCode"
        ],
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "Unique error code"
          },
          "description": {
            "type": "string",
            "description": "Description of the issue"
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/errorResponse_details"
            }
          }
        }
      },
      "errorResponse_details": {
        "required": [
          "description",
          "item"
        ],
        "type": "object",
        "properties": {
          "item": {
            "type": "string",
            "description": "Item the error is associated with, for example, field name, unique identifier for an entity or item in batch"
          },
          "description": {
            "type": "string",
            "description": "Description of the error"
          }
        }
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```

# Sibling pages

* [Add configuration](https://marketing.developer.dotdigital.com/reference/addconfiguration.md)
* [Get configuration](https://marketing.developer.dotdigital.com/reference/getconfiguration.md)
* [Update configuration](https://marketing.developer.dotdigital.com/reference/updateconfiguration.md)
* [Update configuration status](https://marketing.developer.dotdigital.com/reference/updatestatus.md)