---
title: "Get push status for mainframe files"
method: GET
path: "/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/push-status"
tags: ["Build and Configure Mainframe Integration Projects"]
---

# Get push status for mainframe files

`GET /v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/push-status`

## 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}/push-status`
- Auth: HTTP bearer

Computes preflight push status for a Mainframe pipeline before upload starts.

**Features:**
- Compares client-provided proposed snapshot fingerprint against latest remote snapshot
- Returns `canPush=false` with remote files payload when drift is detected
- Validates project/pipeline association before evaluation
- Hidden/system files are excluded from fingerprint evaluation by default (`includeHidden=false`)
- Supports fast UI preflight checks before destructive push operations

**Use Cases:**
- Push preflight guard before user confirms push
- Detecting server-side edits done after last pull/snapshot
- Blocking stale push operations and guiding refresh workflows

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

## Path parameters

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

## Query parameters

- `proposedSnapshotFingerprint` string, required
- `includeHidden` boolean

## Response `200`

Successfully computed push preflight status

- MainframePushStatusResponse: Preflight push-status response indicating whether push can proceed without remote drift.
  - `canPush` boolean: Whether push can proceed with the provided proposed fingerprint.
  - `remoteSnapshotFingerprint` string: Adapter-computed canonical fingerprint of the current remote snapshot.

## Other responses

- `400`: Bad Request - Missing or malformed proposed snapshot fingerprint
- `401`: Unauthorized - Authentication required
- `403`: Forbidden - Missing required permission
- `404`: Not Found - Project or pipeline does not exist
- `500`: Internal Server Error - Failed to compute push status

---

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