---
title: "Create a folder"
method: POST
path: "/api/v1/folders"
tags: ["Folders"]
---

# Create a folder

`POST /api/v1/folders`

## Request body

- FoldersCreateBody
  - `breadcrumbRoot` boolean — When true, breadcrumbs for content in this folder start at this folder, hiding parent folders
  - `name` string, required — Name of the folder to create
  - `parentFolderId` string, uuid — Parent folder ID (omit to create at root level)
  - `scope` 'organization' | 'restricted' — Share scope for the folder
  - `userId` string, uuid — User ID to create the folder as (for org-scoped API keys only)

## Response `201`

Folder created successfully

- FoldersCreateResponse
  - `breadcrumbRoot` boolean, required — Whether breadcrumbs start at this folder
  - `id` string, uuid, required — ID of the created folder
  - `name` string, required — Name of the created folder
  - `ownerId` string, uuid, required — User ID of the folder owner
  - `path` string, required — Full path to the folder
  - `scope` 'organization' | 'restricted', required — Share scope of the folder

## Other responses

- `400` — Invalid request body, scope mismatch with parent folder, or cannot create under restricted folder owned by another user
- `401` — Authentication required
- `404` — Parent folder not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)