Fusion Automation API
Setup
Install this extension.
Create an APS app at https://aps.autodesk.com/myapps (or use an existing one).
Under Callback URL, add — exactly, character-for-character:
vscode://Autodesk.fusion-automation-api/callback
Save the app. If you previously had http://localhost:8080/ registered for an earlier version of this extension, you can remove it.
Copy the app's Client ID into VSCode via the Set Client ID command (type in the top centre bar, or ctrl + shift + p on Windows).
Copy the app's Client Secret into VSCode via the Set Client Secret command.
The first time you run a script remotely, the extension prompts you to sign in to Autodesk Platform Services automatically. If Client ID/Secret aren't configured yet, you'll be walked through creating an APS app and entering them instead of attempting sign-in. If you later change the Client ID, you'll be asked to confirm the callback URL has been added to the new app before the next sign-in.
You can check what Client ID is currently configured at any time with the Show Client ID command.
Running scripts
Navigate to Settings > Extensions > Fusion Automation API to configure:
- Activity ID
- Fusion environment
- Auth mode (
3lo recommended; pat is deprecated)
Have a .ts file open and focused (click inside the editor).
The Run Locally and Run Remote buttons should appear in the top right.
Authentication
Use setting fusion-automation-api.authMode:
3lo (default)
The extension opens your browser to sign in to Autodesk Platform Services. After consent, APS redirects back to a private VSCode URL — vscode://Autodesk.fusion-automation-api/callback — which your operating system hands to VSCode and the extension picks up directly. No local HTTP server is involved. The access token is sent as adsk3LeggedToken on the workitem. Tokens are stored in VSCode secret storage and refreshed until the refresh token expires.
Sign-in is integrated with VSCode's native authentication API. The first time you run a script remotely you will be prompted to sign in automatically. After that, look for Autodesk Platform Services (Production), (Staging), and (Development) under the Accounts icon at the bottom of the activity bar; each one represents a separate session and can be signed in or out independently from there.
Sign-in is supported in desktop VSCode only — VSCode Remote / Web is not supported in this version because the OAuth redirect URL must be a fixed, pre-registered string.
pat (deprecated)
Legacy mode: set a Personal Access Token with Set Personal Access Token (deprecated). The token is sent as PersonalAccessToken.
System Modeler
To create and execute graph workflows. For more info see our help page.
Download a package (e.g. from the help page) and open it in VSCode.
Ensure the System Modeler addin is running in your Autodesk application (eg Fusion).
- This extension connects to the addin. How it connects can be configured in Settings > Extensions > Fusion Automation API.
Open a *.graph.json file to view, create, edit, save, and execute graphs.
Create/edit *.node.ts files to add/edit nodes to your package. The package is automatically refreshed when the node file is saved, or manually via the VSCode command System Modeler: Import package.
TypeScript API definitions (for docs, autocomplete, and to aid AI agents) are automatically fetched when first opening any *.node.ts file, or manually via the VSCode command System Modeler: Set up TypeScript API definitions.
