create_asset

mutationSince v1.0

Create an asset element — a place in the model for an image, document or other file. This creates the element only; no file is attached yet. Call upload_asset_file afterwards to attach the content. The response gives you the new asset's id.

Parameters

NameTypeRequiredDefaultDescription
descriptionStringOptional description of the asset.
labelStringThe name shown for the asset in the Model Navigator and Properties Panel.
folder_idStringFolder to place the new asset in, by ID or name. Leave it out to create it at the root.

Example Request

{"label": "Architecture Diagram", "description": "v2 high-level architecture", "folder_id": "optional-folder-uuid"}

Example Response

{"success": true, "operation_count": 1, "versions": [64], "created": [{"kind": "asset", "id": "7b12...", "label": "Architecture Diagram"}]}

This content was written collaboratively with AI.