Skip to main content
GET
/
test-folders
curl -X GET "https://nunu.ai/api/v1/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
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
curl -X GET "https://nunu.ai/api/v1/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

​
X-Api-Key
string
header
required

API key for authentication

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