Get Many

Get folder documents with different filtering and query options.

Request

POST https://test-uni.cloudplan.biz/api/folder/get_many

{
    "folder_ids": []                (optional, list of strings) a list of folder ids
    "number": 20                    (optional, int) default 20 - max-number of entries to return
    "skip": 0                       (optional, int) default 0 - number of entries to skip
    "sort_modified": true/false     (optional, bool) default sort by name
    "sort_size":  true/false        (optional, bool) default sort by name
    "sort_invert":  true/false      (optional, bool) default sort by name
    "tags": []                      (optional) list of filters for certain tags
                                    e.g. {"tag_id": "56XYZ..."}
                                        {"tag_id": "56ZYXVW.", "val_int":{"gt": 10, "lt":42}}
}

Example 0

REQUEST
{
    "tags_filter": [{"tag_id": "600EC2D1ABB19BF1FAEC5E799C8B1F67"}]
}

REPLY
{
    "result": true,
    "folder_docs": [
    {
        "cp_id": "5FE1ECD7868A8474795A10C3A11683A9",
        "creation_timestamp": 1608641751,
        "individual_rights_user_56A23EB6998F303B134C1C0A723447B0": {
            "delete_acl": true,
            "read_acl": true,
            "write_acl": true,
            "transfer_acl": true,
            "sync_acl": true
        },
        "individual_rights_user_cp_ids": [
            "56A23EB6998F303B134C1C0A723447B0",
            "5FE1DCD3CBD4FD7C0A51A3099CBDB772"
        ],
        "modify_timestamp": 1608641751,
        "name": "channel-test-invites2",
        "parent_folder_cp_id": "",
        "rights_user_56A23EB6998F303B134C1C0A723447B0": {
            "delete_acl": true,
            "read_acl": true,
            "write_acl": true,
            "transfer_acl": true,
            "sync_acl": true
        },
        "rights_user_cp_ids": [
            "56A23EB6998F303B134C1C0A723447B0",
            "5FE1DCD3CBD4FD7C0A51A3099CBDB772"
        ],
        "sync_info_nodes_cp_ids": [
            "58B84023CC9C524F7441DAEE72BC9C73"
        ],
        "sync_node_58B84023CC9C524F7441DAEE72BC9C73": {
            "sync": true
        },
        "version": 1,
        "last_path_ids_rebuild_parent_id": "",
        "path_ids": [],
        "individual_rights_user_5FE1DCD3CBD4FD7C0A51A3099CBDB772": {
            "delete_acl": false,
            "read_acl": true,
            "view_acl": false,
            "sync_acl": false,
            "write_acl": true,
            "weblink_acl": false,
            "transfer_acl": false
        },
        "rights_user_5FE1DCD3CBD4FD7C0A51A3099CBDB772": {
            "delete_acl": false,
            "read_acl": true,
            "write_acl": true,
            "transfer_acl": false,
            "sync_acl": false
        },
        "org_sync_info_56A23D908AD3312676D3D9DF9099A5C9": {
            "timestamp": 1628260881,
            "count_cloud": 1,
            "count_server": 0,
            "count_client": 0
        },
        "corrupted": false
    }
    ]
}

Error Codes

too_many_folder_ids_limit_is_50
folder_not_found
root_folder_not_found
no_storage_node_online
user_has_no_access
node_error

error codes from :doc:`api/user/login`