---
title: "Undeploy Pipelines"
method: POST
path: "/api/v1/pipelines/undeploy"
tags: ["secure", "deploy"]
---

# Undeploy Pipelines

`POST /api/v1/pipelines/undeploy`

Undeploys a pipeline.

## Response `200`

Successful Response

- union
  - ActionIdResponse — Response model containing an action ID.
    - `action_id` string, nullable
  - RedisDiApiV1ModulesSharedResponseError — Model representing an error status.
    - `status` 'error'
    - `error` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-02-02** `f0a3d26cc0c6` — 2 warning
  - removed the optional property `errors` from the response with the `401` status
  - removed the optional property `errors` from the response with the `403` status
- **2025-06-16** `557b7644b943` — 2 breaking, 2 info
  - the response property `anyOf[subschema #1: ActionIdResponse]/action_id` became optional for the status `200`
  - response property `anyOf[subschema #1: ActionIdResponse]/action_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `errors` to the response with the `401` status
  - added the optional property `errors` to the response with the `403` status
- **2025-05-09** `acb8b4d3bbed` — 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/v1/pipelines/undeploy/post.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)