---
title: "Delete a project of any type"
method: DELETE
path: "/v1/integration/projects/{projectId}"
tags: ["Unified Project Lifecycle APIs"]
---

# Delete a project of any type

`DELETE /v1/integration/projects/{projectId}`

## Request

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

Deletes a Continuous Replication, Mainframe, or Advanced Replication (DSL) project
through a single type-agnostic endpoint.

**Features:**
- Handles all three project types uniformly.
- Optional `projectType` hint short-circuits the store probe.
- Optional `forceDelete` bypasses pre-condition guards.
- Returns a structured 409 listing every unmet pre-condition.
- This removes the whole project and every file in it immediately, regardless of each
file's phase. This differs from deleting a single Advanced Replication file (see the
per-file delete endpoint), where an already-committed (approved) file is instead marked
pending_deletion until the next commit, to preserve lineage for shipped content.

**Use Cases:**
- Agent/automation deletes a project regardless of its type.
- Pre-flight a delete and surface blocking conditions to the user.

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

## Path parameters

- `projectId` string, required

## Query parameters

- `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION': Supported project types for unified project operations
- `forceDelete` boolean

## Response `204`

Project deleted

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Project not found (DI-ADAPTER-PRJ-0005)
- `409`: Deletion blocked (DI-ADAPTER-PRJ-0008)
- `500`: Deletion failed (DI-ADAPTER-PRJ-0007)

---

[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)