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

# Create a new project

`POST /projects`

The visibility of the Project will be determined by the available capabilities of the requesting user.
If the user can create private projects, the Project will be private. Otherwise, it will be public.

## Request body

- Project
  - `projectId` string
  - `spaceId` string, uuid — Always returned by the backend. Optional at project creation. If missing, the project will be created in the Personal Space of the user.
  - `parentFolderId` string, uuid — If missing, the project is located at the root level of the Space.
  - `createdAt` string, date-time
  - `name` string, required — The project title should contain the application you want to analyze as well as the simulation method you want to use, e.g. 'Heat exchanger - CHT simulation'.
  - `description` string — A meaningful description of the project.
  - `measurementSystem` 'SI' | 'US_CUSTOMARY', required — The measurement system of the project. Can't be modified.
  - `tags` string[]

## Response `201`

Successful creation of the project

- Project
  - `projectId` string
  - `spaceId` string, uuid — Always returned by the backend. Optional at project creation. If missing, the project will be created in the Personal Space of the user.
  - `parentFolderId` string, uuid — If missing, the project is located at the root level of the Space.
  - `createdAt` string, date-time
  - `name` string, required — The project title should contain the application you want to analyze as well as the simulation method you want to use, e.g. 'Heat exchanger - CHT simulation'.
  - `description` string — A meaningful description of the project.
  - `measurementSystem` 'SI' | 'US_CUSTOMARY', required — The measurement system of the project. Can't be modified.
  - `tags` string[]

## Other responses

- `400` — Bad request.

---

[API](https://skmtc.net/simscale/apis/simscale-api.md) · [All operations](https://skmtc.net/simscale/apis/simscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/simscale/simscale-api/revisions/53223abaceb7/schema)