Docs
Schedule demo Open app

List folders

GET https://app.eraser.io/api/folders

Example request

curl --location 'https://app.eraser.io/api/folders' \
--header 'Authorization: Bearer $YOUR-TOKEN-HERE'

An example request filtering by parent folder:

curl --location 'https://app.eraser.io/api/folders?parentFolderId=xK9mPq2vR' \
--header 'Authorization: Bearer $YOUR-TOKEN-HERE'

An example request with recursive to include all descendants:

curl --location 'https://app.eraser.io/api/folders?recursive=true' \
--header 'Authorization: Bearer $YOUR-TOKEN-HERE'

Example response

[
  {
    "id": "xK9mPq2vR",
    "name": "Design Docs",
    "order": 0,
    "teamId": "tN4wLm8jY",
    "createdBy": "uB7cHd3sW",
    "createdAt": "2025-07-01T12:00:00.000Z",
    "updatedAt": "2025-07-15T09:30:00.000Z",
    "parentFolderId": null
  }
]

Query parameters

parentFolderId string query

Parent folder to list children of. Defaults to null (root folders).

recursive string query

Include all descendant folders. Defaults to false.

  • true
  • false

Responses

200 – Array of folders sorted by createdAt descending

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 required

Creation timestamp

updatedAt string required

Last updated timestamp

parentFolderId string | null required

Parent folder ID, or null if root-level

200 response 
[
  {
    "id": "string",
    "name": "string",
    "order": 0,
    "teamId": "string",
    "createdBy": "string",
    "createdAt": "2026-01-01T00:00:00Z",
    "updatedAt": "2026-01-01T00:00:00Z"
  }
]

400 – Invalid request parameters

401 – Missing or invalid bearer token

403 – Unauthorized

500 – Internal server error