---
title: "List folders"
method: GET
path: "/api/folders"
---

# List folders

`GET /api/folders`

Returns root-level folders by default. Filter by parentFolderId or use recursive=true to include nested folders.

## Query parameters

- `parentFolderId` string
- `recursive` 'true' | 'false'

## Response `200`

Array of folders sorted by createdAt descending

- Folder[]
  - `id` string, required — Unique identifier
  - `name` string, required — Folder name
  - `order` integer, required — Sort order among siblings
  - `teamId` string, required — Team ID
  - `createdBy` string, required — Creator's user ID
  - `createdAt` string, date-time, required — Creation timestamp
  - `updatedAt` string, date-time, required — Last updated timestamp
  - `parentFolderId` string, nullable, required — Parent folder ID, or null if root-level

## Other responses

- `400` — Invalid request parameters
- `401` — Missing or invalid bearer token
- `403` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/eraser/apis/render.md) · [All operations](https://skmtc.net/eraser/apis/render/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eraser/render/versions/c31350b435dc/schema)