Autodesk Construction Cloud

Supergood | Autodesk Construction Cloud API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Autodesk Construction Cloud API

Programmatically access Autodesk Construction Cloud (ACC) projects, documents, field data, and cost objects with a stable REST API. Supergood builds and operates production-grade, unofficial ACC integrations so your team can automate web workflows without heavy custom engineering.

Plain English: Autodesk Construction Cloud is construction management software used by owners, GCs, and specialty contractors to connect design coordination, document control, field execution, and cost management. An unofficial API lets you programmatically pull project lists, folders and files (Docs and Sheets), RFIs, quality/safety issues, contracts and payment applications—and push new records or updates back into ACC.

For a tech company integrating with ACC, this means you can ingest real-time job data to power dashboards, sync drawings and docs into your app, trigger RFIs from computer vision detections, automate submittal/RFI workflows, or reconcile contracts and pay apps with your ERP. You can also upload files and photos, attach evidence to field issues, create payment applications from your procurement system, and keep stakeholder systems (ERP, analytics, scheduling, BIM viewers) in sync.

What is Autodesk Construction Cloud?

Autodesk Construction Cloud (https://construction.autodesk.com/) is a cloud platform that connects project teams across the entire construction lifecycle—from design collaboration to document management, field operations, and cost controls. Teams use ACC to centralize drawings and documents, track RFIs and submittals, manage quality and safety issues, coordinate models, and run budgets, contracts, change orders, and payment applications.

Core product areas include:

  • Documents & Sheets (versioned files, drawings, markups, transmittals)
  • Project Management (RFIs, Submittals, Meetings)
  • Field Operations (Issues, Checklists/Forms, Photos, Daily Logs, Assets)
  • Cost Management (Budgets, Contracts/POs, Change Orders, Payment Applications)
  • Design Collaboration & Model Coordination (BIM models, clash management)

Common data entities:

  • Accounts (companies), Users, and Permissions
  • Projects (metadata, locations, dates, status)
  • Folders, Files, and Sheets (versions, markups, references)
  • RFIs and Submittals (workflows, reviews, attachments)
  • Issues (quality/safety), Checklists/Forms, Photos, Assets
  • Budgets, Cost Codes, Contracts (subcontracts, purchase orders), Change Orders
  • Payment Applications, Schedule of Values (SOV) line items, Retainage

The Autodesk Construction Cloud Integration Challenge

Construction teams rely on ACC daily, but turning portal-based workflows into API-driven automation is non-trivial:

  • Module-specific interfaces: Docs, Build (Project/Field/Cost), and Model tools each have distinct UX and granular entitlements
  • Enterprise security: Autodesk ID, SSO/OAuth, and MFA complicate headless automation
  • Versioned files: Large drawings and models with versions, markups, and references require careful synchronization
  • Financial rigor: Permissions, approvals, retainage, and audit trails must be respected programmatically
  • Organizational model: Accounts/hubs and project-level permissions vary widely across stakeholders

How Supergood Creates Autodesk Construction Cloud APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your ACC tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses so you can integrate once and rely on consistent objects across modules
  • Aligns with customer entitlements and role-based permissions to ensure compliant access

Use Cases

Project Data Sync

  • Mirror projects, companies, and users into your internal systems
  • Keep project metadata current for analytics and reporting
  • Normalize addresses, geolocation, statuses, and dates for multi-tenant operations

Documents & Sheets Automation

  • Synchronize folders, files, and drawing sheets (with versions) to your platform
  • Attach photos and documents to records in your app with time-limited URLs
  • Trigger downstream workflows on file updates (e.g., model updated → run checks)

RFI Workflow Integration

  • Create RFIs from defect detections or field observations automatically
  • Track ball-in-court, due dates, and reviewer status to power SLA alerts
  • Link RFIs back to sheets, details, or model elements for context

Cost Management & ERP Sync

  • Push contracts and payment applications from procurement into ACC
  • Reconcile change orders, SOV, retainage, and statuses with your ERP
  • Pull financial statuses for forecasting and cash-flow analytics

Field Reporting and Quality/Safety

  • Ingest issues, checklists/forms, and daily logs into your data warehouse
  • Trigger follow-ups and approvals when thresholds or conditions are met
  • Unify QA/QC evidence (photos, documents) across teams

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "usr_72b10f",
    "name": "Project Manager",
    "entitlements": ["projects", "docs", "rfis", "cost_management"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Projects

GET /projects: List projects with filters and summary details.

Query parameters

  • accountId: string
  • status: active | archived | pending
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "projectId": "prj_f18a20",
      "name": "Riverview Mixed-Use",
      "projectNumber": "RV-2026-014",
      "status": "active",
      "accountId": "acc_88b32e",
      "address": {
        "line1": "2000 Riverview Dr",
        "city": "Portland",
        "region": "OR",
        "postalCode": "97201",
        "country": "US"
      },
      "startDate": "2026-01-10",
      "endDate": null,
      "updatedAt": "2026-01-22T15:32:10Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Documents & Sheets (Docs)

GET /projects/{projectId}/docs/files: List files within Docs with optional folder scoping and version info.

Query parameters

  • folderId: string (optional)
  • includeVersions: boolean (default false)
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "fileId": "file_9c2f01",
      "name": "A-101_FloorPlan.pdf",
      "path": "/Sheets/Architecture/A-101_FloorPlan.pdf",
      "folderId": "fld_18aa55",
      "mimeType": "application/pdf",
      "version": 7,
      "sizeBytes": 2451876,
      "downloadUrl": "https://signed.supergood.ai/dl/eyJ...",
      "updatedAt": "2026-01-21T08:44:00Z"
    }
  ],
  "page": 1,
  "pageSize": 100,
  "total": 1
}

POST /projects/{projectId}/docs/files: Upload a new file into Docs.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_f18a20/docs/files \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "folderId": "fld_18aa55",
    "fileName": "QA_Photo_2026-01-21.jpg",
    "uploadToken": "upl_7f91a2",
    "metadata": {"source": "field-app", "issueId": "iss_1234"}
  }'

Example response

{
  "fileId": "file_b71e09",
  "name": "QA_Photo_2026-01-21.jpg",
  "version": 1,
  "folderId": "fld_18aa55",
  "status": "uploaded",
  "createdAt": "2026-01-21T12:05:10Z"
}

RFIs

POST /projects/{projectId}/rfis: Create a new RFI with workflow metadata and optional attachments.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_f18a20/rfis \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "subject": "Clarify expansion joint at gridline G",
    "question": "Confirm detail and spacing for expansion joint at curtain wall interface.",
    "dueDate": "2026-02-03",
    "priority": "normal",
    "ballInCourtUserId": "usr_45af1d",
    "assigneeCompanyId": "cmp_03cd21",
    "specSection": "07 50 00",
    "sheetRefs": ["A-301", "A-502"],
    "private": false,
    "attachments": [
      {"fileName": "curtainwall_detail.png", "uploadToken": "upl_98dc3a"}
    ],
    "referenceId": "cam-detect-8893"
  }'

Example response

{
  "rfiId": "rfi_67c21a",
  "number": 42,
  "status": "open",
  "createdAt": "2026-01-21T09:12:33Z",
  "referenceId": "cam-detect-8893"
}

Payment Applications (Cost Management)

POST /projects/{projectId}/contracts/{contractId}/payment-applications: Create a payment application against a contract (subcontract/PO) with SOV line items and retainage.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_f18a20/contracts/cnt_3aa91d/payment-applications \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "periodStart": "2026-01-01",
    "periodEnd": "2026-01-31",
    "applicationNumber": "APP-2026-01",
    "lineItems": [
      {
        "sovItemId": "sov_033100_01",
        "description": "Concrete foundations",
        "scheduledValue": 250000.00,
        "workCompletedThisPeriod": 40000.00,
        "materialsStored": 0.00,
        "retainagePercent": 10.0
      },
      {
        "sovItemId": "sov_071300_02",
        "description": "Waterproofing",
        "scheduledValue": 80000.00,
        "workCompletedThisPeriod": 15000.00,
        "materialsStored": 5000.00,
        "retainagePercent": 10.0
      }
    ],
    "attachments": [
      {"fileName": "app_cert.pdf", "uploadToken": "upl_7fa223"}
    ],
    "notes": "Includes stored materials for waterproofing roll stock."
  }'

Example response

{
  "paymentApplicationId": "pay_51af80",
  "status": "submitted",
  "contractId": "cnt_3aa91d",
  "totalRequested": 60000.00,
  "createdAt": "2026-01-21T11:20:44Z"
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of projects, docs/sheets, RFIs, and financial objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Autodesk Construction Cloud role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., payment app approvals, RFI reviews)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume document sync and pay app processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened ACC adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Autodesk evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Autodesk Construction Cloud modules can this integration cover?

Supergood supports workflows across commonly used modules such as Documents/Sheets, Project Management (RFIs, Submittals), Field Operations (Issues, Forms/Checklists, Photos), and Cost Management (Budgets, Contracts, Change Orders, Payment Applications), subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync contracts and payment applications to our ERP?

Yes. We can normalize contracts and pay apps to match your ERP schema (e.g., cost codes, retainage, SOV line items) and deliver updates via webhooks or polling while complying with rate and permission constraints.

Q: Are large file downloads and uploads supported for Docs and Sheets?

Yes. We support downloading artifacts via time-limited URLs and uploading via signed/resumable flows with checksum validation and time-boxed tokens.

Ready to automate your Autodesk Construction Cloud workflows?

Supergood can have your ACC integration live in days with no ongoing engineering maintenance.

Get Started →

Read more