List folders

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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 Params
string

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

string
enum
Defaults to false

Include all descendant folders. Defaults to false.

Allowed:
Responses

400

Invalid request parameters

401

Missing or invalid bearer token

403

Unauthorized

500

Internal server error

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json