---
title: "Add a piece to a platform"
method: POST
path: "/v1/pieces"
tags: ["pieces"]
---

# Add a piece to a platform

`POST /v1/pieces`

Add a piece to a platform

## Request body

- union
  - object — Private Piece
    - `packageType` 'ARCHIVE', required
    - `scope` 'PLATFORM', required
    - `pieceName` string, required
    - `pieceVersion` string, required
    - `pieceArchive` object, required
      - `filename` string, required
      - `data` unknown, required
      - `type` 'file', required
      - `mimetype` string
  - object — NPM Piece
    - `packageType` 'REGISTRY', required
    - `scope` 'PLATFORM', required
    - `pieceName` string, required
    - `pieceVersion` string, required

## Response `201`

Default Response

- object

---

[API](https://skmtc.dev/activepieces/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/activepieces/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activepieces/activepieces-documentation/revisions/745e4b7f764a/schema)