---
title: "POST /v1/projects/{id}"
method: POST
path: "/v1/projects/{id}"
tags: ["projects"]
---

# POST /v1/projects/{id}

`POST /v1/projects/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `notifyStatus` union
    - 'NEVER'
    - 'ALWAYS'
    - 'NEW_ISSUE'
  - `displayName` string
  - `plan` object
    - `tasks` number
    - `pieces` string[]
    - `piecesFilterType` union
      - 'NONE'
      - 'ALLOWED'

## Response `200`

Default Response

- object
  - `id` string, required
  - `created` string, required
  - `updated` string, required
  - `ownerId` string, required
  - `displayName` string, required
  - `notifyStatus` union, required
    - 'NEVER'
    - 'ALWAYS'
    - 'NEW_ISSUE'
  - `platformId` string, required
  - `externalId` string
  - `usage` object, required
    - `tasks` number, required
    - `teamMembers` number, required
  - `plan` object, required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `projectId` string, required
    - `name` string, required
    - `minimumPollingInterval` number, required
    - `piecesFilterType` union, required
      - 'NONE'
      - 'ALLOWED'
    - `pieces` string[], required
    - `connections` number, required
    - `teamMembers` number, required
    - `tasks` number, required

## Changes

> 38 revisions in range; 1 could not be searched.

- **2024-09-03** `b95c8c8e8262` — 1 warning, 4 info
  - removed the optional property `deleted` from the response with the `200` status
  - the endpoint scheme security `apiKey` was added to the API
  - added the new optional request property `plan`
  - added the required property `plan` to the response with the `200` status
  - …1 more
- **2024-07-04** `6067892aa453` — 2 breaking, 1 warning, 2 info
  - removed the required property `plan` from the response with the `200` status
  - removed the required property `usage` from the response with the `200` status
  - removed the request property `plan`
  - the endpoint scheme security `apiKey` was removed from the API
  - …1 more
- **2024-07-04** `719995374e3d` — 1 warning, 2 info
  - removed the request property `plan/teamMembers`
  - added `subschema #3` to the `notifyStatus` request property `anyOf` list
  - added `subschema #3` to the `notifyStatus` response property `anyOf` list for the response status `200`
- **2024-04-17** `2127db57a884` — 6 info
  - added the new optional request property `plan/pieces`
  - added the new optional request property `plan/piecesFilterType`
  - request body became optional
  - the request property `displayName` became optional
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/rantirai/apis/activepieces-documentation/changes/v1/projects/:id/post.md)

---

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