---
title: "Delete a mainframe pipeline by ID"
method: DELETE
path: "/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}"
tags: ["Build and Configure Mainframe Integration Projects"]
---

# Delete a mainframe pipeline by ID

`DELETE /v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}`
- Auth: HTTP bearer

Deletes a mainframe pipeline by its ID within a project. Supports optional deletion of pipeline configuration only.

**Process Overview:**
- Validates that the project and pipeline exist and the user has permission to delete the pipeline.
- If `configOnly` is true, deletes only the pipeline configuration from the Data Integrity Suite.
- If `configOnly` is false (default), performs a full deletion including runtime components.

**Configuration Only Deletion Behavior:**
Delete pipeline configuration only. This action is not recommended.
Use this option only when the runtime processes for this pipeline no longer exist. This action cannot be undone.
Exporting the pipeline before continuing is highly recommended.

After the pipeline configuration is deleted from the Data Integrity Suite:
Manual cleanup of runtime processes will be needed.

**Required Permissions:** `replication-pipeline::delete` when permission harmonization is enabled; otherwise, `replication-pipeline::manage`.

## Path parameters

- `projectId` string, required
- `pipelineId` string, required

## Query parameters

- `configOnly` boolean

## Response `204`

Pipeline deleted successfully.

## Other responses

- `400`: Invalid request payload.
- `401`: Unauthorized - Authentication required, valid credentials not provided
- `403`: Forbidden - User lacks the required 'replication-pipeline::delete' or legacy 'replication-pipeline::manage' permission
- `404`: Pipeline not found.
- `500`: Internal Server Error - Unexpected server error during deletion.

---

[API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)