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

# Create Query Folder Under Parent

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

## Request

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

Creates a new query folder as a child of the specified parent folder. The gateway resolves the parent folder's path and creates the new folder at "{parentPath}/{folderName}".

## Path parameters

- `projectId` string, required
- `parentFolderId` 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 "/"
- `404`: Parent folder not found
- `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)