Skip to main content
GET
Authentication: Any authenticated API key
Retrieve a paginated list of test folders for your project. Each item includes the resolved path and parent_path strings, so callers don’t need to deal with folder UUIDs directly. Pagination is over the alphabetized full list. These folder paths are the same strings accepted by folder_path in List Tests, Create Test, and Update Test.

Query Parameters

page
integer
default:"0"
Page number (0-indexed)
page_size
integer
default:"25"
Results per page (1-100)

Response

data
TestFolder[]
required
Array of test folder objects
pagination
object
required
Pagination metadata (page, page_size, total_count, total_pages)

TestFolder Object

id
string
required
Folder UUID
name
string
required
Folder name (just the leaf segment, not the full path)
path
string
required
Resolved folder path (e.g. "regression/smoke")
parent_path
string
Resolved parent path, or null for top-level folders
parent_folder_id
string
Parent folder UUID, or null for top-level folders
description
string
Optional folder description
tags
string[]
required
Tags assigned to the folder
created_at
string
required
ISO 8601 timestamp when the folder was created
modified_at
string
required
ISO 8601 timestamp when the folder was last modified
created_by_name
string
Display name of the folder creator
modified_by_name
string
Display name of the most recent editor

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

projectId
string
required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Query Parameters

page
integer
default:0

Page number (0-indexed)

page_size
integer
default:25

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

data
object[]
pagination
object