create_asset
mutationSince v1.0Create 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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
description | String | — | Optional description of the asset. | |
label | String | ✓ | The name shown for the asset in the Model Navigator and Properties Panel. | |
folder_id | String | — | Folder 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.