---
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, required
    - 'NEVER'
    - 'ALWAYS'
  - `displayName` string, required
  - `plan` object
    - `teamMembers` number
    - `tasks` number, required

## 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'
  - `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
    - `stripeCustomerId` string, required
    - `stripeSubscriptionId` string, nullable
    - `subscriptionStartDatetime` string, required
    - `flowPlanName` string, required
    - `minimumPollingInterval` number, required
    - `connections` number, required
    - `teamMembers` number, required
    - `tasks` number, required
    - `tasksPerDay` number, nullable

## Changes

- **2024-03-01** `bfaf80ac9c5e` — 1 breaking, 1 info
  - removed the required property `type` from the response with the `200` status
  - the response property `platformId` became required for the status `200`
- **2024-02-25** `37771607c596` — 8 breaking, 3 info
  - removed the required property `usage/connections` from the response with the `200` status
  - removed the required property `usage/consumedTasks` from the response with the `200` status
  - removed the required property `usage/consumedTasksToday` from the response with the `200` status
  - removed the required property `usage/created` from the response with the `200` status
  - …7 more
- **2024-02-22** `b8aa27750656` — 1 info
  - the endpoint scheme security `apiKey` was added to the API
- **2023-12-17** `e4e2ec56a169` — 2 breaking
  - the response property `plan/stripeSubscriptionId` became optional for the status `200`
  - the response property `plan/tasksPerDay` became optional for the status `200`
- **2023-12-03** `7b0cc60eed56` — 7 breaking, 2 warning, 1 info
  - added the new required request property `plan/teamMembers`
  - request body became required
  - removed `subschema #3` from the `notifyStatus` request property `anyOf` list
  - the request property `displayName` became required
  - …6 more

[Change 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/7d2c62096ae1/schema)