Fusion¶

Endpoints related to fusion.

GET /fusion-oauth-settings/¶

List Fusion OAuth provider configurations for the current user’s bureau.

List Fusion OAuth provider configurations for the current user’s bureau.

Filter options: - filter[provider]=autodesk-fusion-bureau: Show only bureau-level configs - filter[provider]=autodesk-fusion-user: Show only user-level configs

Returns:: ResourceList: The provider configurations
Raises:: FusionIntegrationDisabled: If Fusion feature is not enabled

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
404 Not Found – fusion-provider-not-found: The requested Fusion OAuth provider configuration was not found
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
400 Bad Request – invalid-provider-type: The provider type must be either ‘autodesk-fusion-user’ or ‘autodesk-fusion-bureau’ duplicate-key-error: A configuration already exists for this bureau or user

POST /fusion-oauth-settings/¶

Create a new Fusion OAuth provider configuration.

Create a new Fusion OAuth provider configuration.

Only one configuration of each type is allowed per bureau: - If a configuration already exists for the specified provider type, it will be updated

Args:

payload: The configuration data including:

provider: Either ‘autodesk-fusion-bureau’ or ‘autodesk-fusion-user’
client_id: Client ID from Autodesk
client_secret: Client secret from Autodesk

Returns:

tuple: (empty string, 201 Created, {“Location”: uri})

Raises:

ValueError: If provider type is invalid FusionIntegrationDisabled: If Fusion feature is not enabled

Status Codes:

201 Created – Resource created successfully
404 Not Found – fusion-provider-not-found: The requested Fusion OAuth provider configuration was not found
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
400 Bad Request – invalid-provider-type: The provider type must be either ‘autodesk-fusion-user’ or ‘autodesk-fusion-bureau’ duplicate-key-error: A configuration already exists for this bureau or user

Response Headers:

Location – URI of the created resource

GET /fusion-oauth-settings/{uuid}/¶

Get a single Fusion OAuth provider configuration by UUID.

Get a single Fusion OAuth provider configuration by UUID.

Security constraints: - All configurations are accessible to bureau members - Returns 404 for both non-existent resources and unauthorized access attempts

Args:: uuid: UUID of the configuration to retrieve
Returns:: dict: The configuration record (client_secret excluded)
Raises:: RecordNotFound: If configuration not found or user lacks access permission FusionIntegrationDisabled: If Fusion feature is not enabled

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

200 OK – Successful response
404 Not Found – fusion-provider-not-found: The requested Fusion OAuth provider configuration was not found
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
400 Bad Request – invalid-provider-type: The provider type must be either ‘autodesk-fusion-user’ or ‘autodesk-fusion-bureau’ duplicate-key-error: A configuration already exists for this bureau or user

PUT /fusion-oauth-settings/{uuid}/¶

Update an existing Fusion OAuth provider configuration.

Update an existing Fusion OAuth provider configuration.

Note: Provider type cannot be changed after creation.

Args:: uuid: UUID of configuration to update payload: Updated configuration data (client_id, client_secret)
Returns:: tuple: (empty string, 204 No Content, {})
Raises:: RecordNotFound: If configuration not found ValueError: If attempting to change provider type FusionIntegrationDisabled: If Fusion feature is not enabled

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

204 No Content – Resource updated successfully
404 Not Found – fusion-provider-not-found: The requested Fusion OAuth provider configuration was not found
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
400 Bad Request – invalid-provider-type: The provider type must be either ‘autodesk-fusion-user’ or ‘autodesk-fusion-bureau’ duplicate-key-error: A configuration already exists for this bureau or user

GET /fusion-work-item/¶

Get a list of fusion work items with optional filters.

Get a list of fusion work items with optional filters.

Retrieves a paginated list of Fusion work items, supporting filtering by various criteria including related resource URI, status, or bureau.

Returns:: ResourceList: Paginated list of work items with total count
Raises:: Unauthorized: If Fusion feature is not enabled for the bureau

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
404 Not Found – fusion-work-item-not-found: The requested fusion work item was not found
401 Unauthorized – autodesk-fusion-feature-disabled: Fusion Feature Flag is not enabled for this bureau

GET /fusion-work-item/{uuid}/¶

Get a single fusion work item by UUID.

Get a single fusion work item by UUID.

Retrieves a specific Fusion work item and returns it with enhanced data including queue entries and related resource information.

Args:: uuid: The UUID of the fusion work item to retrieve
Returns:: dict: The work item data with URI, queue entries, and related resource URI
Raises:: Unauthorized: If Fusion feature is not enabled for the bureau RecordNotFound: If the work item doesn’t exist

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

200 OK – Successful response
404 Not Found – fusion-work-item-not-found: The requested fusion work item was not found
401 Unauthorized – autodesk-fusion-feature-disabled: Fusion Feature Flag is not enabled for this bureau

GET /fusion-settings/¶

List Fusion settings for the current user’s bureau.

List Fusion settings for the current user’s bureau.

Most bureaus will have only one settings record.

Returns:: ResourceList: The settings records
Raises:: Unauthorized: If user doesn’t have permission FusionIntegrationDisabled: If Fusion feature is not enabled

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
404 Not Found – fusion-settings-not-found: The requested Fusion settings were not found
400 Bad Request – duplicate-fusion-settings: A Fusion settings record already exists for this bureau
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau

POST /fusion-settings/¶

Create a new Fusion settings record.

Create a new Fusion settings record.

Each bureau can have only one Fusion settings record.

Args:: payload: The settings data
Returns:: tuple: (empty string, status code, headers)
Raises:: InvalidParameters: If settings already exist Unauthorized: If user doesn’t have permission FusionIntegrationDisabled: If Fusion feature is not enabled

Status Codes:

201 Created – Resource created successfully
404 Not Found – fusion-settings-not-found: The requested Fusion settings were not found
400 Bad Request – duplicate-fusion-settings: A Fusion settings record already exists for this bureau
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau

Response Headers:

Location – URI of the created resource

GET /fusion-settings/{uuid}/¶

Get a single Fusion settings record by UUID.

Get a single Fusion settings record by UUID.

Args:: uuid: UUID of the settings to retrieve
Returns:: dict: The settings record
Raises:: RecordNotFound: If settings not found Unauthorized: If user doesn’t have permission FusionIntegrationDisabled: If Fusion feature is not enabled

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

200 OK – Successful response
404 Not Found – fusion-settings-not-found: The requested Fusion settings were not found
400 Bad Request – duplicate-fusion-settings: A Fusion settings record already exists for this bureau
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau

PUT /fusion-settings/{uuid}/¶

Update an existing Fusion settings record.

Update an existing Fusion settings record.

Args:: uuid: UUID of settings to update payload: Updated settings data
Returns:: tuple: (empty string, status code, headers)
Raises:: RecordNotFound: If settings not found Unauthorized: If user doesn’t have permission FusionIntegrationDisabled: If Fusion feature is not enabled

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

204 No Content – Resource updated successfully
404 Not Found – fusion-settings-not-found: The requested Fusion settings were not found
400 Bad Request – duplicate-fusion-settings: A Fusion settings record already exists for this bureau
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau

GET /fusion-additive-setup/¶

Get a list of fusion additive setups with optional filters

Get a list of fusion additive setups with optional filters

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
404 Not Found – fusion-additive-setup-not-found: The requested fusion additive setup was not found
401 Unauthorized – autodesk-fusion-feature-disabled: Fusion Feature Flag is not enabled for this bureau

GET /fusion-additive-setup/{uuid}/¶

Get a single fusion additive setup by UUID

Get a single fusion additive setup by UUID

Parameters:

uuid (string) – The UUID of the resource

Status Codes:

200 OK – Successful response
404 Not Found – fusion-additive-setup-not-found: The requested fusion additive setup was not found
401 Unauthorized – autodesk-fusion-feature-disabled: Fusion Feature Flag is not enabled for this bureau

GET /fusion-settings/hubs/¶

List all Fusion 360 hubs available to the current user.

List all Fusion 360 hubs available to the current user.

This method retrieves all hubs that the user has access to in Fusion 360, which requires valid OAuth tokens to be configured for the current user.

Returns:: ResourceList: The list of hubs with their IDs and names
Raises:: Unauthorized: If user doesn’t have permission or no token is found FusionIntegrationDisabled: If Fusion feature is not enabled

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
401 Unauthorized – fusion-token-not-found: No valid Fusion OAuth token was found for the current user

GET /fusion-settings/hubs/<hub_id>/projects/¶

List active projects in a Fusion 360 hub.

List active projects in a Fusion 360 hub.

This method retrieves all active projects available in the specified hub, which requires valid OAuth tokens to be configured for the current user. Only projects with “ACTIVE” status in Fusion 360 are included in the results.

Args:: hub_id: The hub ID to list projects for (format: urn:adsk.ace:prod.scope:{uuid})
Returns:: ResourceList: The list of active projects with their IDs and names
Raises:: Unauthorized: If user doesn’t have permission or no token is found FusionIntegrationDisabled: If Fusion feature is not enabled

Query Parameters:

limit (integer) – Maximum number of resources to return
offset (integer) – Number of resources to skip
sort (string) – Sort order (prefix with ‘-’ for descending)

Status Codes:

200 OK – Successful response with list of resources
403 Forbidden – fusion-integration-disabled: The Fusion integration is not enabled for this bureau
401 Unauthorized – fusion-token-not-found: No valid Fusion OAuth token was found for the current user