---
title: "Partially update project metadata of any type"
method: PATCH
path: "/v1/integration/projects/{projectId}"
tags: ["Unified Project Lifecycle APIs"]
---

# Partially update project metadata of any type

`PATCH /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

Applies a JSON Merge Patch (RFC 7396) to project metadata through the store
selected by the optional `projectType` hint, or the project's persisted type
when omitted.

**Features:**
- Supports Continuous Replication, Mainframe Replication, and Advanced Replication (DSL) projects.
- Omitted fields are preserved; an explicit `null` removes the corresponding stored value.
- Nested objects (`emailSettings`, `deploySettings`) are merged member-by-member, not replaced wholesale.

**Use Cases:**
- Update a project's description without resending the full project payload.
- Toggle email alerting or adjust deploy timeout defaults independently.

**Authorization:** Requires `replication-pipeline::update` 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

## Response `204`

Project metadata updated

## Other responses

- `400`: Invalid patch request or project type (DI-ADAPTER-PRJ-0014)
- `401`: Unauthorized
- `403`: Forbidden — requires replication-pipeline::update or legacy replication-pipeline::manage
- `404`: Project not found (DI-ADAPTER-PRJ-0005)
- `409`: Project changed concurrently (DI-ADAPTER-PRJ-0015)
- `415`: Unsupported media type — Content-Type must be application/merge-patch+json
- `502`: Data Catalog patch failed (DI-ADAPTER-PRJ-0016)
- `503`: Data Catalog is unavailable (DI-ADAPTER-PRJ-0017)

---

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