Get list of Sub Folders

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

This API fetches the list of sub folders in a team folder.

Endpoints

OAuth Scope

WorkDrive.teamfolders.READCopied!

Request Example

cURL
cURL
Deluge
Copied!
curl --request GET \
  --url https://www.zohoapis.com/workdrive/api/v1/teamfolders/{teamfolder_id}/folders \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'

Path Parameters

teamfolder_idstring(Required)

The unique ID of a team folder.

Query Parameters

Note:

Query parameter name should be URL encoded with UTF-8 Charset. For more info, refer here

page[limit]string(Optional)

Limit indicates the number of items to be listed.
(The maximum limit is 50)

For More Details about pagination, refer here

page[offset]string(Optional)

Offset indicates from where the listing should start.

sortstring(Optional)

Sorting can be done with these fields

  • name
  • kind
  • shared_time
  • last_modified
  • created_time

To sort in descending order, prefix the field value with a hyphen (-).

Eg. sort=-name sorts results by name in descending order.

Allowed Values :
Show Values
nameCopied!
kindCopied!
shared_timeCopied!
last_modifiedCopied!
created_timeCopied!
-nameCopied!
-kindCopied!
-shared_timeCopied!
-last_modifiedCopied!
-created_timeCopied!
Copied!Copy all as JSON Array

Response Example

R221

U001

R008

R004

F000

200
200
400
401
403
404
500
Copied!
  {
    "data": [
      {
        "id": "ly9zm3bd32ac7cfdd45448e435bd20a6be500",
        "type": "files",
        "attributes": {
          "modified_by_zuid": "747938014",
          "is_locked": false,
          "conv_engine_type": 0,
          "is_fillable_resource": false,
          "is_published": false,
          "destination_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
          "storage_info": {
            "size": "0 bytes",
            "storage_used": "0 bytes",
            "files_count": 0,
            "folders_count": 0,
            "size_in_bytes": 0,
            "storage_used_in_bytes": 0
          },
          "type": "folder",
          "created_time_i18": "Apr 13, 12:02 AM",
          "modified_time_in_millisecond": 1618252322314,
          "opened_time": "Apr 13, 12:02 AM",
          "status_change_time": "Apr 13, 12:02 AM",
          "download_url": "https://www.zohoapis.com/workdrive/download/ly9zm3bd32ac7cfdd45448e435bd20a6be500",
          "comment_badge_count": 0,
          "is_app_associated": false,
          "created_time": "Apr 13, 12:02 AM",
          "lock_status": 2,
          "is_folder": true,
          "resource_type": 1001,
          "is_email_in_upload": false,
          "display_attr_name": "April",
          "created_by": "Zylker Creation",
          "display_html_name": "April",
          "labels": [],
          "parent_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
          "name": "April",
          "status_change_time_in_millisecond": 1618252322314,
          "permalink": "https://www.zohoapis.com/workdrive/folder/ly9zm3bd32ac7cfdd45448e435bd20a6be500",
          "favorite": false,
          "new_badge_count": 0,
          "status": 1,
          "modified_time_i18": "Apr 13, 12:02 AM",
          "opened_time_i18": "Apr 13, 12:02 AM",
          "extn": "",
          "view_pref": {
            "sort_by": "last_modified",
            "sort_order": "desc",
            "filtered_by": "all",
            "layout": "list"
          },
          "shortcut_link": "",
          "status_change_time_i18": "Apr 13, 12:02 AM",
          "description": "",
          "uploaded_time_in_millisecond": 1618252322317,
          "thumbnail_url": "",
          "title": "",
          "files_view_pref": {
            "sort_by": "last_modified",
            "sort_order": "desc",
            "filtered_by": "all",
            "layout": "list"
          },
          "modified_time": "Apr 13, 12:02 AM",
          "library_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
          "icon_class": "folder",
          "created_time_in_millisecond": 1618252322314,
          "owner": "747937818",
          "creator": "747938014",
          "capabilities": {
            "can_read": true,
            "can_share": true,
            "can_remove_share": false,
            "can_delete": false,
            "can_edit": true,
            "can_create_files": true,
            "can_upload_files": true,
            "can_trash": true,
            "can_rename": true,
            "can_restore": false,
            "can_copy": true,
            "can_move": true,
            "can_zip": true,
            "can_download": true,
            "can_emailattach": true,
            "can_publish": true,
            "can_create_task": false,
            "can_share_support": true,
            "can_label": true,
            "can_trash_files": true
          },
          "uploaded_time_i18": "Apr 13, 12:02 AM",
          "is_external_upload": false,
          "watch_preference": {
            "watch": false,
            "notifyemail": false,
            "notifybell": false
          },
          "opened_time_in_millisecond": 1618252322314,
          "edit_badge_count": 0,
          "share_data": [],
          "uploaded_time": "Apr 13, 12:02 AM",
          "has_folders": false,
          "service_type": "upload",
          "display_url_name": "April",
          "is_unread": false,
          "modified_by": "Zylker Creation",
          "embed_props": {}
        },
        "relationships": {
          "folders": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/folders",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/folders"
            }
          },
          "comments": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/comments",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/comments"
            }
          },
          "previewinfo": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/previewinfo",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/previewinfo"
            }
          },
          "unzip": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/unzip",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/unzip"
            }
          },
          "publiclink": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/publiclink",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/publiclink"
            }
          },
          "resourceproperty": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/resourceproperty",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/resourceproperty"
            }
          },
          "parentfolders": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/parentfolders",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/parentfolders"
            }
          },
          "shortcut": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/shortcut",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/shortcut"
            }
          },
          "importfile": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/importfile",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/importfile"
            }
          },
          "versions": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/versions",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/versions"
            }
          },
          "supportshare": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/supportshare",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/supportshare"
            }
          },
          "permissions": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/permissions",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/permissions"
            }
          },
          "timeline": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/timeline",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/timeline"
            }
          },
          "files": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/files",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/files"
            }
          },
          "saveastemplate": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/saveastemplate",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/saveastemplate"
            }
          },
          "links": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/links",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/links"
            }
          },
          "copy": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/copy",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/copy"
            }
          },
          "previewzip": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/previewzip",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/previewzip"
            }
          },
          "tasks": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/tasks",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/tasks"
            }
          },
          "breadcrumbs": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/breadcrumbs",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/breadcrumbs"
            }
          },
          "entity": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/entity",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/entity"
            }
          },
          "custommetadata": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/custommetadata",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/custommetadata"
            }
          },
          "statistics": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/statistics",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/statistics"
            }
          },
          "appdata": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/relationships/appdata",
              "related": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500/appdata"
            }
          }
        },
        "links": {
          "self": "https://www.zohoapis.com/workdrive/files/ly9zm3bd32ac7cfdd45448e435bd20a6be500"
        }
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R221",
        "title": "Invalid inputs"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "U001",
        "title": "User not logged in. Please Log in"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R008",
        "title": "Unauthorized access"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R004",
        "title": "Invalid resourceId passed. Please use a valid resourceId"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F000",
        "title": "General Exception"
      }
    ]
  }
                
Show full