---
title: "Pull selected mainframe files by file IDs"
method: POST
path: "/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/pull"
tags: ["Build and Configure Mainframe Integration Projects"]
---

# Pull selected mainframe files by file IDs

`POST /v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/pull`

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

Hydrates selected files by `fileIds` for Mainframe pipelines using parallel fetching.

**Features:**
- Selected-file hydration only (no full-pipeline download)
- Parallel fetch for improved performance
- Returns file payload with content and metadata (including size)
- Validates project/pipeline association before hydration

**Use Cases:**
- Initial selective pull for user-selected files
- Manual refresh of a scoped subset of tracked files
- Recovering specific remote files during conflict resolution workflows

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

## Path parameters

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

## Query parameters

- `fileIds` string[], required
- `includeHidden` boolean

## Response `200`

Successfully hydrated selected files

- MainframePullFilesResponse: Selected-file hydration response
  - `projectId` string: Project ID
  - `pipelineId` string: Pipeline ID
  - `requestedFileCount` integer: Number of files requested
  - `hydratedFileCount` integer: Number of files successfully hydrated
  - `files` MainframeHydratedFile[]: Hydrated files
    - `id` string: File ID
    - `fileName` string: File name
    - `size` integer: File size in bytes
    - `content` string: Base64-encoded file content
    - `fileApplicationType` string: File application type
    - `contentHash` string: SHA-256 content hash

## Other responses

- `400`: Bad Request - Invalid request or empty fileIds
- `401`: Unauthorized - Authentication required
- `403`: Forbidden - Missing required permission
- `404`: Not Found - Pipeline or requested file IDs not found
- `500`: Internal Server Error - Selected pull execution 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)