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

# Create a project

`POST /v1/projects`

Create a project for a team

## Request body

- object
  - `teamId` string
  - `name` string, required
  - `sourceRepository` string
  - `branchName` string
  - `runtime` 'python3.13' | 'python3.14' | 'node22' | 'node24', required
  - `transport` 'stdio' | 'sse' | 'streamablehttp'
  - `rootDirectory` string
  - `settings` object
    - `installCommand` string
    - `buildCommand` string
    - `buildOutputDir` string
    - `startCommand` string
  - `environmentVariables` object[]
    - `key` string, required
    - `value` string, required
    - `isSecret` boolean

## Response `200`

The project has been created successfully

- object
  - `id` string, required
  - `name` string, required
  - `teamId` string, required
  - `environments` object[], required
    - `id` string, required
    - `name` string, required
  - `productionEnvironment` object, nullable, required
    - `id` string, required
    - `name` string, required
  - `sourceRepository` string, nullable, required
  - `runtime` 'python3.13' | 'python3.14' | 'node22' | 'node24', required
  - `transport` 'stdio' | 'sse' | 'streamablehttp', nullable, required
  - `rootDirectory` string, nullable, required
  - `buildCommand` string, nullable, required
  - `buildOutputDir` string, nullable, required
  - `installCommand` string, nullable, required
  - `startCommand` string, nullable, required
  - `createdAt` string, date-time, required

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404

---

[API](https://skmtc.dev/alpic/apis/alpic-api-2.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api-2/revisions/262875478562/schema)