Upload Asset

Create a new asset in a model and attach a file in a single multipart upload. Broadcasts AssetAdded + AssetFileAttached collaboration operations — browser users see the new asset in real-time. 100 MB max.

AuthenticationBearer mpt_... or OAuth JWT

Plan RequirementPro+

Parameters

Name	Type	Required	Description
`label`	`Multipart text`	—	[Upload Asset] Display name for the asset. Multipart text field. Defaults to the uploaded filename if omitted.
`model_id`	`String (UUID)`	✓	[Upload Asset] UUID of the model the new asset belongs to. Path parameter.
`file`	`Multipart file (max 100 MB)`	✓	[Upload Asset] The binary file to attach. Multipart form field — any field name other than 'label' is treated as the file. Filename and content-type are taken from the multipart headers.
`model_id`	`String (UUID)`	✓	[Upload Asset] UUID of the model the new asset belongs to. Path parameter.
`file`	`Multipart file (max 100 MB)`	✓	[Upload Asset] The binary file to attach. Multipart form field — any field name other than 'label' is treated as the file. Filename and content-type are taken from the multipart headers.
`label`	`Multipart text`	—	[Upload Asset] Display name for the asset. Multipart text field. Defaults to the uploaded filename if omitted.

Example Response

{"id": "new-asset-uuid", "label": "Architecture Diagram", "description": null, "filename": "architecture.png", "content_type": "image/png", "size_bytes": 184320, "tags": [], "created_at": "2026-05-16T12:34:56Z", "updated_at": "2026-05-16T12:34:56Z"}