Manage Folders with the Kiteworks REST API

import requests
from get_access_token import KWOAuthClient

def list_top_level_folders(base_url, access_token):
    """Return all top-level folders accessible to the authenticated user."""
    url = f"{base_url}/rest/folders/top"
    headers = {
        "X-Accellion-Version": "28",
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    }
    params = {
        # "orderBy": "name:asc",
        # "offset": 0,
        # "limit": 10,
        # "deleted": "false",
    }
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()

def main():
    base_url = input("Enter Base URL for Kiteworks instance: ")
    client = KWOAuthClient(base_url)
    access_token = client.get_access_token()
    folders = list_top_level_folders(base_url, access_token)
    print(folders)

if __name__ == "__main__":
    main()

import requests
from get_access_token import KWOAuthClient

def list_child_folders(base_url, access_token, parent_folder_id):
    """Return the immediate subfolders of the given parent folder."""
    url = f"{base_url}/rest/folders/{parent_folder_id}/folders"
    headers = {
        "X-Accellion-Version": "28",
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    }
    params = {
        # "name": "My Sub-folder",
        # "name:contains": "Sub",
        # "deleted": "false",
        # "orderBy": "name:asc",
        # "offset": 0,
        # "limit": 10,
    }
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json().get("data", [])

def main():
    base_url = input("Enter Base URL for Kiteworks instance: ")
    client = KWOAuthClient(base_url)
    access_token = client.get_access_token()
    folder_id = input("Enter parent folder ID: ")
    folders = list_child_folders(base_url, access_token, folder_id)
    print(folders)

if __name__ == "__main__":
    main()

import requests
from get_access_token import KWOAuthClient

def list_files_in_folder(base_url, access_token, folder_id):
    """Return all files contained within the given folder."""
    url = f"{base_url}/rest/folders/{folder_id}/files"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "X-Accellion-Version": "28",
        "Content-Type": "application/json",
    }
    params = {
        # "name": "my-file.csv",
        # "userId": "a111b222-...",
        # "orderBy": "name:asc",
        # "offset": 0,
        # "limit": 10,
    }
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json().get("data", [])

def main():
    base_url = input("Enter Base URL for Kiteworks instance: ")
    client = KWOAuthClient(base_url)
    access_token = client.get_access_token()
    folder_id = input("Enter folder ID: ")
    files = list_files_in_folder(base_url, access_token, folder_id)
    print(files)

if __name__ == "__main__":
    main()

import requests
import json
from get_access_token import KWOAuthClient

def create_folder(base_url, access_token, parent_folder_id, folder_data):
    """
    Create a folder inside parent_folder_id.
    Pass parent_folder_id="0" to create a top-level folder.
    """
    url = f"{base_url}/rest/folders/{parent_folder_id}/folders"
    headers = {
        "X-Accellion-Version": "28",
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    }
    params = {"returnEntity": "true"}
    response = requests.post(url, headers=headers, params=params, data=json.dumps(folder_data))
    response.raise_for_status()
    return response.json()

def main():
    base_url = input("Enter Base URL for Kiteworks instance: ")
    client = KWOAuthClient(base_url)
    access_token = client.get_access_token()

    parent_id = input("Enter parent folder ID (or 0 for top-level): ")

    folder_data = {
        "name": "The new Folder",
        "description": "Created via the Kiteworks API.",
        "secure": False,
        "syncable": False,
        # Optional fields — uncomment and set values as needed:
        # "expire": "",
        # "fileLifetime": 0,
        # "rename": False,
    }

    result = create_folder(base_url, access_token, parent_id, folder_data)
    print(result)

if __name__ == "__main__":
    main()