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

# POST /v1/projects

`POST /v1/projects`

## Request body

- object
  - `displayName` string, required
  - `externalId` string

## Response `201`

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
  - `releasesEnabled` boolean, required
  - `usage` object, required
    - `tasks` number, required
    - `teamMembers` number, required
    - `aiTokens` number, required
    - `nextLimitResetDate` string, 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
    - `aiTokens` number, required
  - `analytics` object, required
    - `totalUsers` number, required
    - `activeUsers` number, required
    - `totalFlows` number, required
    - `activeFlows` number, required

## Changes

- **2024-12-31** `3c05b427e5b5` — 2 info
  - added the required property `releasesEnabled` to the response with the `201` status
  - added the required property `usage/nextLimitResetDate` to the response with the `201` status
- **2024-11-25** `613e124d2041` — 1 info
  - added the required property `analytics` to the response with the `201` status
- **2024-11-25** `086c2138cb1b` — 1 warning
  - changed the pattern of the request property `displayName` from `^[^:/?&=#@]+$` to `^[^./]+$`
- **2024-11-12** `499ae054e9e9` — 1 breaking, 2 info
  - added the pattern `^[^:/?&=#@]+$` to the request property `displayName`
  - added the required property `plan/aiTokens` to the response with the `201` status
  - added the required property `usage/aiTokens` to the response with the `201` status
- **2024-09-13** `225ff954244e` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

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

---

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