---
title: "Delete deal pipeline"
method: DELETE
path: "/admin/deal_pipelines/{id}"
tags: ["Deal pipelines"]
---

# Delete deal pipeline

`DELETE /admin/deal_pipelines/{id}`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/deal_pipelines/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

A pipeline that still holds deals needs `new_pipeline_id` and `new_stage_id`: its deals are moved there first. Up to 30 deals move inline and the pipeline is deleted in the same request; more than 30 are moved by a background job and the pipeline is deleted once the move finishes, so a large pipeline may still be listed for a short while after a 204.

## Path parameters

- `id` integer, required

## Query parameters

- `new_pipeline_id` integer
- `new_stage_id` integer

## Response `204`

Success, no body.

## Other responses

- `403`: The credentials are valid but this user may not perform the action (permissions, a read-only token, or API access switched off).
- `404`: No record with that id is visible to this user. Records owned by other users that you cannot see also answer 404.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)