Subfolders lists

Retrieves a list of subfolders within the specified folder. Use this endpoint to fetch all direct subfolders under a given parent folder for navigation or management purposes.

Method
GET /folders/{folderId}/subfolders

Request Body Parameters:
No request body is required for this GET endpoint. The {folderId} path parameter identifies the parent folder (e.g., use "root" for top-level folders).

Example Request (cURL)

Response Codes:

200 OK — Successfully returns a list of subfolders with details like ID, name, and parent ID.

401 Unauthorized — Authentication token is missing or invalid.

403 Forbidden — Insufficient permissions to access the folder contents.

404 Not Found — Specified folder ID does not exist.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "status": 200,
  "message": "Subfolders found successfully.",
  "data": {
    "data": [
      {
        "id": "viq64bpid6p7x4y17fcdliux",
        "bucketId": "rfmuc7uiqxadlvz1fnxmk8td",
        "parentId": "uegxerbdayv4503dsdu6um7w",
        "hashUrl": "RQf4YGDZWzHlhyg0s1ccuFTFObXurmpQycDb5qFNnFA",
        "name": "Test doc",
        "visibility": "private",
        "isDelete": false,
        "createdAt": "2026-05-12T12:38:34.581Z",
        "updatedAt": "2026-05-12T12:38:34.581Z",
        "deletedAt": null
      },
      {
        "id": "kncm5puycfl745whcru0zpl3",
        "bucketId": "rfmuc7uiqxadlvz1fnxmk8td",
        "parentId": "uegxerbdayv4503dsdu6um7w",
        "hashUrl": "0-ZL-qKjAXStcmFwp094zhqZ1k4SXXKtJjzLvkZeWdY",
        "name": "Project test",
        "visibility": "private",
        "isDelete": false,
        "createdAt": "2026-05-12T12:45:06.698Z",
        "updatedAt": "2026-05-12T12:45:06.698Z",
        "deletedAt": null
      }
    ],
    "total": 2,
    "parentFolder": {
      "id": "uegxerbdayv4503dsdu6um7w",
      "name": "Test",
      "bucketId": "rfmuc7uiqxadlvz1fnxmk8td"
    }
  }
}

Request

Request Code Samples

Responses