---
title: "Initiates a preliminary download of the pipeline."
method: POST
path: "/pipeline/{pipelineId}/preliminary-download"
tags: ["Pipeline"]
---

# Initiates a preliminary download of the pipeline.

`POST /pipeline/{pipelineId}/preliminary-download`

## Path parameters

- `pipelineId` string, required

## Request body

- StartPreliminaryDownloadEndpointInput
  - `sendEmail` boolean — Whether to email the user when the download is ready.

## Response `200`

OK

- StartPreliminaryDownloadEndpointOutput
  - `downloadId` string, required — The id of the preliminary download that was initiated.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/fdb89a6eb2fb/schema)