---
title: "Create project"
method: POST
path: "/v2/teams/{team_id}/projects"
tags: ["v2", "Projects"]
---

# Create project

`POST /v2/teams/{team_id}/projects`

## Path parameters

- `team_id` union, required
  - string, uuid
  - string

## Request body

- CreateProjectRequest
  - `name` string, required — Project name
  - `description` string, nullable — Optional description

## Response `201`

Success

- Project
  - `id` union — Project ID
    - string, uuid
    - string
  - `team_id` union, required — Team ID
    - string, uuid
    - string
  - `name` string, required — Project name
  - `description` string, nullable — Optional description
  - `created_by` union, required — User ID who created the project
    - string, uuid
    - string
  - `created_at` string, date-time — Project created at
  - `updated_at` string, date-time — Project updated at
  - `is_archived` boolean — Grave marker for soft deletion
  - `team_wide_permission` 'read' | 'write', nullable — If set, all team members get this permission on docs in the project

## Other responses

- `400` — Bad request
- `422` — Validation Error
- `500` — Server error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)