Data -- Query Folders

Create Query Folder Under Parent

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}".

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

Path parameters

projectIdstring required

ID of the Project

parentFolderIdstring required

ID of the parent Query Folder

Request body

folderNamestring

Response

Folder created successfully

idstring

Unique identifier of the folder (UUID)

namestring

Display name of the folder

pathstring

Full path of the folder in the hierarchy

parentIdstring

ID of the parent folder, null if root-level

createdAtstring

Timestamp when the folder was created (ISO 8601)

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Monthly Reports",
  "path": "/reports/monthly",
  "parentId": "550e8400-e29b-41d4-a716-446655440001",
  "createdAt": "2025-01-15T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.