WorkDocs / Client / describe_root_folders



Describes the current user’s special folders; the RootFolder and the RecycleBin. RootFolder is the root of user’s files and folders and RecycleBin is the root of recycled items. This is not a valid action for SigV4 (administrative API) clients.

This action requires an authentication token. To get an authentication token, register an application with Amazon WorkDocs. For more information, see Authentication and Access Control for User Applications in the Amazon WorkDocs Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.describe_root_folders(
  • AuthenticationToken (string) –


    Amazon WorkDocs authentication token.

  • Limit (integer) – The maximum number of items to return.

  • Marker (string) – The marker for the next set of results. (You received this marker from a previous call.)

Return type:



Response Syntax

    'Folders': [
            'Id': 'string',
            'Name': 'string',
            'CreatorId': 'string',
            'ParentFolderId': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'ModifiedTimestamp': datetime(2015, 1, 1),
            'ResourceState': 'ACTIVE'|'RESTORING'|'RECYCLING'|'RECYCLED',
            'Signature': 'string',
            'Labels': [
            'Size': 123,
            'LatestVersionSize': 123
    'Marker': 'string'

Response Structure

  • (dict) –

    • Folders (list) –

      The user’s special folders.

      • (dict) –

        Describes a folder.

        • Id (string) –

          The ID of the folder.

        • Name (string) –

          The name of the folder.

        • CreatorId (string) –

          The ID of the creator.

        • ParentFolderId (string) –

          The ID of the parent folder.

        • CreatedTimestamp (datetime) –

          The time when the folder was created.

        • ModifiedTimestamp (datetime) –

          The time when the folder was updated.

        • ResourceState (string) –

          The resource state of the folder.

        • Signature (string) –

          The unique identifier created from the subfolders and documents of the folder.

        • Labels (list) –

          List of labels on the folder.

          • (string) –

        • Size (integer) –

          The size of the folder metadata.

        • LatestVersionSize (integer) –

          The size of the latest version of the folder metadata.

    • Marker (string) –

      The marker for the next set of results.


  • WorkDocs.Client.exceptions.UnauthorizedOperationException

  • WorkDocs.Client.exceptions.UnauthorizedResourceAccessException

  • WorkDocs.Client.exceptions.InvalidArgumentException

  • WorkDocs.Client.exceptions.FailedDependencyException

  • WorkDocs.Client.exceptions.ServiceUnavailableException