---
title: "Export mainframe pipelines as ZIP"
method: POST
path: "/v1/integration/mainframe/projects/{projectId}/export"
tags: ["Build and Configure Mainframe Integration Projects"]
---

# Export mainframe pipelines as ZIP

`POST /v1/integration/mainframe/projects/{projectId}/export`

## Request

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

Exports multiple mainframe pipelines as a ZIP archive containing their configurations and associated files.

**Process Overview:**
1. **Request Validation** - Validates project ID and pipeline IDs
2. **Pipeline Collection** - Gathers all specified pipelines and their configurations
3. **Content Aggregation** - Collects pipeline configurations, parameters, and associated files
4. **Archive Creation** - Packages all pipeline data into a ZIP archive preserving structure
5. **Stream Preparation** - Prepares the archive for download
6. **Response Delivery** - Returns the ZIP file with appropriate headers

**Key Features:**
- Bulk export support for multiple pipelines in a single operation
- Includes pipeline configurations, parameters, and associated files
- Efficient streaming for large export sets
- Directory structure preservation in archive

**Use Cases:**
- Backup multiple pipeline configurations
- Transfer pipeline configurations between environments
- Archive project pipeline configurations

**Required Permissions:** `replication-pipeline::view`

## Path parameters

- `projectId` string, required

## Request body

- string[]: Set of pipeline IDs to export

## Response `200`

ZIP archive of exported pipelines

## Other responses

- `400`: Bad Request - Validation failed due to one of the following reasons: - Invalid project ID - Invalid or empty pipeline IDs set - Pipeline IDs contain invalid formats
- `401`: Unauthorized - Authentication required, valid credentials not provided
- `403`: Forbidden - User lacks 'replication-pipeline::view' permission
- `404`: Not Found - Resource not found due to one of the following reasons: - Project does not exist - One or more specified pipelines do not exist within the project
- `500`: Internal Server Error - Server encountered an unexpected condition, such as: - Pipeline export operation failure - ZIP archive creation failure

---

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