acc-docs

ACC Docs — Document Management via APS API

Manage ACC Docs for:

"$ARGUMENTS"

Prerequisites

• APS credentials set up (use acc-api-setup skill first)
• APSClient class available (from acc-api-setup)
• Hub ID and Project ID known (run the discovery script in acc-api-setup)
• pip install requests

---

Script 1: List all files in a folder (recursive)

import os, requests

# ── Configuration ─────────────────────────────────────────────────────────────
HUB_ID     = os.environ.get("APS_HUB_ID",     "b.YOUR_HUB_ID")
PROJECT_ID = os.environ.get("APS_PROJECT_ID", "b.YOUR_PROJECT_ID")   # with b. prefix

BASE_URL = "https://developer.api.autodesk.com"
# ─────────────────────────────────────────────────────────────────────────────

def get_top_folders(client, hub_id, project_id):
    """Get the top-level folders in an ACC project."""
    url  = f"{BASE_URL}/project/v1/hubs/{hub_id}/projects/{project_id}/topFolders"
    data = client.get(url)
    return data.get("data", [])

def list_folder_contents(client, project_id, folder_id, depth=0, results=None):
    """Recursively list all items in a folder."""
    if results is None:
        results = []
    url  = f"{BASE_URL}/data/v1/projects/{project_id}/folders/{folder_id}/contents"

    page_url = url
    while page_url:
        data    = client.get(page_url)
        items   = data.get("data", [])
        links   = data.get("links", {})

        for item in items:
            item_type = item["type"]   # "folders" or "items"
            attrs     = item["attributes"]
            indent    = "  " * depth

            if item_type == "folders":
                results.append({
                    "type":     "Folder",
                    "name":     attrs["name"],
                    "id":       item["id"],
                    "depth":    depth,
                    "path":     indent + "📁 " + attrs["name"],
                })
                # Recurse into subfolder
                list_folder_contents(client, project_id, item["id"], depth + 1, results)

            elif item_type == "items":
                # Get the latest version info
                version = item.get("relationships", {}).get("tip", {}).get("data", {})
                results.append({
                    "type":        "File",
                    "name":        attrs["displayName"],
                    "id":          item["id"],
                    "version_id":  version.get("id", ""),
                    "depth":       depth,
                    "path":        indent + "📄 " + attrs["displayName"],
                })

        # Handle pagination
        next_link = links.get("next", {})
        page_url  = next_link.get("href") if next_link else None

    return results

# ── Run ───────────────────────────────────────────────────────────────────────
if __name__ == "__main__":
    # client = APSClient(...)  # from acc-api-setup

    folders = get_top_folders(client, HUB_ID, PROJECT_ID)
    all_files = []

    for folder in folders:
        print(f"\n=== {folder['attributes']['name']} ===")
        contents = list_folder_contents(client, PROJECT_ID, folder["id"])
        for item in contents:
            print(item["path"])
        all_files.extend(contents)

    print(f"\nTotal items: {len(all_files)}")