---
title: "Create Query Folder"
method: POST
path: "/data/projects/{projectId}/queries/folders"
tags: ["Data -- Query Folders"]
---

# Create Query Folder

`POST /data/projects/{projectId}/queries/folders`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/queries/folders`
- Auth: HTTP bearer

Creates a new query folder at the root level. The folder name is used to build the path (e.g. folderName "Reports" becomes path "/Reports"). The name cannot contain "/"; use Create Query Folder Under Parent for nested folders.

## Path parameters

- `projectId` string, required

## Request body

- QueryFolderCreateRequest
  - `folderName` string

## Response `201`

Folder created successfully

- QueryFolderItem: Represents a query folder
  - `id` string: Unique identifier of the folder (UUID)
  - `name` string: Display name of the folder
  - `path` string: Full path of the folder in the hierarchy
  - `parentId` string: ID of the parent folder, null if root-level
  - `createdAt` string: Timestamp when the folder was created (ISO 8601)

## Other responses

- `400`: Folder name is empty or contains "/"
- `409`: Folder already exists at this path

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)