curl -X GET "https://nunu.ai/api/v1/project/your-project-id/test-folders?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "f01a3b1c-9d2e-4f05-8c7a-1a2b3c4d5e6f",
"name": "smoke",
"path": "regression/smoke",
"parent_path": "regression",
"parent_folder_id": "e10b2c3d-4e5f-6789-abcd-ef0123456789",
"description": "Critical-path smoke tests",
"tags": ["nightly"],
"created_at": "2026-03-01T10:00:00.000000+00:00",
"modified_at": "2026-03-15T14:30:00.000000+00:00",
"created_by_name": "Test Owner",
"modified_by_name": "Test Owner"
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
Test Folders
List Test Folders
Retrieve a paginated list of test folders for the authenticated project.
GET
/
project
/
{projectId}
/
test-folders
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/test-folders?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "f01a3b1c-9d2e-4f05-8c7a-1a2b3c4d5e6f",
"name": "smoke",
"path": "regression/smoke",
"parent_path": "regression",
"parent_folder_id": "e10b2c3d-4e5f-6789-abcd-ef0123456789",
"description": "Critical-path smoke tests",
"tags": ["nightly"],
"created_at": "2026-03-01T10:00:00.000000+00:00",
"modified_at": "2026-03-15T14:30:00.000000+00:00",
"created_by_name": "Test Owner",
"modified_by_name": "Test Owner"
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
Authentication: Any authenticated API key
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
integer
default:"0"
Page number (0-indexed)
integer
default:"25"
Results per page (1-100)
Response
TestFolder[]
required
Array of test folder objects
object
required
Pagination metadata (
page, page_size, total_count, total_pages)TestFolder Object
string
required
Folder UUID
string
required
Folder name (just the leaf segment, not the full path)
string
required
Resolved folder path (e.g.
"regression/smoke")string
Resolved parent path, or
null for top-level foldersstring
Parent folder UUID, or
null for top-level foldersstring
Optional folder description
string[]
required
Tags assigned to the folder
string
required
ISO 8601 timestamp when the folder was created
string
required
ISO 8601 timestamp when the folder was last modified
string
Display name of the folder creator
string
Display name of the most recent editor
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/test-folders?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "f01a3b1c-9d2e-4f05-8c7a-1a2b3c4d5e6f",
"name": "smoke",
"path": "regression/smoke",
"parent_path": "regression",
"parent_folder_id": "e10b2c3d-4e5f-6789-abcd-ef0123456789",
"description": "Critical-path smoke tests",
"tags": ["nightly"],
"created_at": "2026-03-01T10:00:00.000000+00:00",
"modified_at": "2026-03-15T14:30:00.000000+00:00",
"created_by_name": "Test Owner",
"modified_by_name": "Test Owner"
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
Authorizations
API key for authentication
Path Parameters
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Query Parameters
Page number (0-indexed)
Results per page (1-100)
Required range:
1 <= x <= 100