---
title: "Delete Pipeline"
method: DELETE
path: "/api/v2/pipelines/{name}"
tags: ["v2", "pipelines"]
---

# Delete Pipeline

`DELETE /api/v2/pipelines/{name}`

Replaces a pipeline with an empty inactive pipeline and resets it.

This is done to ensure that no artifacts (offsets, schema, data streams etc.) are left behind,
as this may cause errors and unexpected behavior when trying to re-create the pipeline.

## Path parameters

- `name` string, required — Pipeline name

## Response `204`

Successful Response

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-04-29** `d5de67e6bd60` — 3 warning, 3 info
  - added the new `cdc_validation_error` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `cdc_validation_error` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `cdc_validation_error` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the optional property `errors/anyOf[subschema #1]/items/remediation` to the response with the `401` status
  - …2 more
- **2026-02-03** `1cfaddb924d7` — 3 info
  - the `details` response's property default value `{}` was removed for the status `401`
  - the `details` response's property default value `{}` was removed for the status `403`
  - the `details` response's property default value `{}` was removed for the status `404`
- **2026-02-02** `f0a3d26cc0c6` — 1 info
  - endpoint added
- **2025-02-27** `b0ed6c7dac42` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redis/apis/redis-data-integration-api/changes/api/v2/pipelines/:name/delete.md)

---

[API](https://skmtc.dev/redis/apis/redis-data-integration-api.md) · [All operations](https://skmtc.dev/redis/apis/redis-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redis/redis-data-integration-api/revisions/30f630f0aac5/schema)