---
title: "POST /api/pipelines/{id}/promote/"
method: POST
path: "/api/pipelines/{id}/promote/"
tags: ["pipelines"]
---

# POST /api/pipelines/{id}/promote/

`POST /api/pipelines/{id}/promote/`

Copy a specified version of the pipeline's source package to its target package, publishing it as a new version with the provided commit message.

## Path parameters

- `id` string, required

## Request body

- PackagePromotionPipeline
  - `id` string, uuid — Surrogate primary key
  - `name` string, required — Used to visually identify the promotion pipeline. Must be formatted as the collection and name parts of the target and source package registry ids, e.g. foo/bar
  - `source` object, required
    - `id` string, uuid — Surrogate primary key
    - `name` string
    - `kind` string, required
    - `version` string
    - `share_dependencies` boolean
    - `config` string, required
    - `public` boolean
    - `organizations` string[]
    - `owner_organization` string
    - `message` string
    - `updated_at` string, date-time
    - `verbose_name` string, nullable — Human-readable name
    - `is_locked` boolean
    - `lock_owner` object
      - `user` object, required
        - `id` string, uuid
        - `email` string, email
      - `created_at` string, date-time
  - `target` object, required
    - `id` string, uuid — Surrogate primary key
    - `name` string
    - `kind` string, required
    - `version` string
    - `share_dependencies` boolean
    - `config` string, required
    - `public` boolean
    - `organizations` string[]
    - `owner_organization` string
    - `message` string
    - `updated_at` string, date-time
    - `verbose_name` string, nullable — Human-readable name
    - `is_locked` boolean
    - `lock_owner` object
      - `user` object, required
        - `id` string, uuid
        - `email` string, email
      - `created_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `201`

---

[API](https://skmtc.dev/pixiebrix/apis/pixiebrix-api.md) · [All operations](https://skmtc.dev/pixiebrix/apis/pixiebrix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pixiebrix/pixiebrix-api/revisions/941ab9eb01d6/schema)