Download Asset

Download the file attached to an asset. Returns a 302 redirect to a short-lived presigned S3 URL — clients must follow redirects to fetch the binary. Returns 404 with code 'no_file' if the asset has no file attached.

Pass ?locale=de to get that language's variant. If the asset has no file for that language the default file is returned instead, so a caller can always ask for its reader's language without checking first.

Images and PDFs open in the browser tab by default; pass ?disposition=attachment to force a save.

AuthenticationBearer mpt_... or OAuth JWT

Plan RequirementPro+

Parameters

Name	Type	Required	Description
`model_id`	`String (UUID)`	✓	[Download Asset] UUID of the model. Path parameter.
`asset_id`	`String (UUID)`	✓	[Download Asset] UUID of the asset whose file should be downloaded. Path parameter.
`locale`	`String`	—	[Download Asset] Download this language's variant of the file, for example `de`. If the asset has no file for that language, the default file is returned instead — the request does not fail. Leave it out to get the default file.
`disposition`	`String`	—	[Download Asset] Pass `attachment` to make the browser save the file instead of displaying it. Left out, images and PDFs open in the tab.

Example Response

HTTP/1.1 302 Found
Location: https://s3.example.com/...presigned...
Cache-Control: no-cache