---
title: "Promote To Pipeline"
method: POST
path: "/v2/pipeline"
tags: ["discovery-v2"]
---

# Promote To Pipeline

`POST /v2/pipeline`

## Headers

- `authorization` string, nullable
- `X-Tenant` string, nullable

## Request body

- PromoteRequest
  - `parcel_key` string, required
  - `buy_box` string, required
  - `query_hash` string, required
  - `draft` DiscoveryDraft
    - `markets` string[], required
    - `must` Rule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `unknown` 'exclude' | 'review', nullable
    - `preferred` PreferredRule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `weight` number, required
    - `verdict_cutoffs` Cutoffs, required
      - `pursue` number, required
      - `monitor` number, required

## Response `202`

Successful Response

- PromoteResponse
  - `property_id` string, uuid, required
  - `pipeline_item_id` string, uuid, required
  - `buy_box_match_id` string, uuid, required
  - `diligence_job_id` string, uuid, required
  - `status` string, required

## Other responses

- `422` — Validation Error

---

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