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

# Delete a project substitution variable

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

## Request

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

Deletes a project- or pipeline-scoped substitution variable by ID. Requires `replication-pipeline::manage`.

## Path parameters

- `projectId` string, required

## Query parameters

- `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION', required: Supported project types for unified project operations
- `pipelineId` string
- `variableId` string, required

## Response `200`

Variable deleted

- UnifiedProjectVariableResponse
  - `id` string
  - `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION'
  - `name` string
  - `value` string
  - `type` 'PARAMETER_DATA_TYPE_STRING' | 'PARAMETER_DATA_TYPE_ENCRYPTED_STRING'
  - `description` string
  - `lastModifiedBy` string
  - `lastUpdatedAt` string, date-time

## Other responses

- `400`: Missing or invalid variable identifier
- `401`: Unauthorized
- `403`: Forbidden — requires replication-pipeline::manage
- `404`: Project, pipeline, or variable not found
- `500`: Connect Portal variable deletion failed

---

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