acc-coordinate

ACC Coordinate — Model Coordination API

Automate ACC Coordinate workflows for:

"$ARGUMENTS"

Prerequisites

• APS credentials configured (see acc-api-setup skill)
• Project container ID = ACC project ID without the b. prefix
• pip install requests

---

API base URL and key concepts

Base:  https://developer.api.autodesk.com/modelcoordination/modelset/v3
Auth:  2-legged token (data:read scope)

Key objects:

• Container: the coordination space for a project (ID = project ID without b.)
• Model Set: a named collection of activated Revit/IFC models grouped for clash testing
• Clash Set: the result of a clash test between two model sets or within one
• Clash Group: a group of related clashes (e.g. all ducts vs all beams)
• Clash Instance: a single clash between two specific elements

---

Script 1: List all model sets in a project

import os, requests

CONTAINER_ID = os.environ.get("APS_CONTAINER_ID")  # project ID without b.
BASE_MC = "https://developer.api.autodesk.com/modelcoordination/modelset/v3"

def list_model_sets(client, container_id):
    """List all model sets (coordination spaces) in an ACC project."""
    url  = f"{BASE_MC}/containers/{container_id}/modelsets"
    data = client.get(url)
    model_sets = []
    for ms in data.get("results", []):
        model_sets.append({
            "Model Set Name": ms.get("name", ""),
            "Model Set ID":   ms.get("modelSetId", ""),
            "Created":        ms.get("createTime", ""),
            "Status":         ms.get("status", ""),
            "Model Count":    len(ms.get("modelSetVersions", [{}])[-1:][0].get("models", []))
                              if ms.get("modelSetVersions") else 0,
        })
    return model_sets

if __name__ == "__main__":
    # client = APSClient(...)
    model_sets = list_model_sets(client, CONTAINER_ID)
    for ms in model_sets:
        print(f"  {ms['Model Set Name']:30} ID: {ms['Model Set ID']}")

---