---
title: "Create Folder"
method: POST
path: "/spaces/{spaceId}/folders"
tags: ["Folders"]
---

# Create Folder

`POST /spaces/{spaceId}/folders`

Create a new Folder. If `parentFolderId` is missing, the folder will be created at the root level of the Space. Folder name clashes are allowed.

## Path parameters

- `spaceId` string, uuid, required

## Request body

- Folder
  - `resourceType` 'PROJECT' | 'FOLDER'
  - `folderId` string, uuid
  - `parentFolderId` string, uuid — Can be missing if the folder is at the root level of the Space
  - `spaceId` string, uuid
  - `name` string, required
  - `numberOfItems` integer
  - `createdAt` string, date-time
  - `lastModifiedAt` string, date-time

## Response `201`

Folder created successfully

- Folder
  - `resourceType` 'PROJECT' | 'FOLDER'
  - `folderId` string, uuid
  - `parentFolderId` string, uuid — Can be missing if the folder is at the root level of the Space
  - `spaceId` string, uuid
  - `name` string, required
  - `numberOfItems` integer
  - `createdAt` string, date-time
  - `lastModifiedAt` string, date-time

## Other responses

- `403` — Insufficient permissions

---

[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)