mint:read
Get Asset
get_asset
Gets status and the Mint handoff link for one of your worlds, models, asset packs, materials, audio files, or Studio projects.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- asset_typerequired
"world" | "model" | "asset_pack" | "material" | "material_pack" | "image" | "audio" | "studio_project"
- asset_idrequired
string
- contextrequired
string
Describe the user's goal and why this tool helps in 15-25 words. Do not include credentials, personal data, identifiers, URLs, emails, or account addresses.
Example request
{
"asset_type": "model",
"asset_id": "mn785pg330fdx30ty4achjv80985ne5z"
}Example response
{
"type": "model",
"id": "mn785pg330fdx30ty4achjv80985ne5z",
"name": "Blush Cloud Loveseat",
"status": "succeeded",
"assetStage": "final",
"previewImageUrl": "https://cdn.mint.gg/images/models/blush-cloud-loveseat-preview.webp",
"workflowStage": "final_completed",
"workflowStageStartedAt": 1745625300000,
"workflowStageUpdatedAt": 1745625595000,
"lastHeartbeatAt": 1745625594000,
"workflowStageLastError": null,
"failureClass": null,
"failureCode": null,
"failureReason": null,
"moderationCategories": [],
"retryable": false,
"retryGuidance": null,
"chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
"chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
"presentationHint": "Show chatUrl to the user as the Open in Mint link. You may render previewImageUrl inline when useful, but do not show raw CDN, thumbnail, pano, mesh, audio file, asset id, or provider URLs as text.",
"nextSteps": [
{
"tool": "wait_for_status",
"action": "wait_for_final",
"description": "Poll until Mint reports final output eligibility before trying to use files in a code project.",
"input": {
"asset_type": "model",
"asset_id": "mn785pg330fdx30ty4achjv80985ne5z",
"until_stage": "final"
}
},
{
"tool": "list_asset_artifacts",
"action": "list_downloadable_artifacts",
"description": "After the asset reaches final, list downloadable artifacts and choose a downloadable artifact_id.",
"input": {
"asset_type": "model",
"asset_id": "mn785pg330fdx30ty4achjv80985ne5z"
}
},
{
"tool": "get_asset_artifact_manifest",
"action": "fetch_artifact_manifest",
"description": "Fetch a ready-to-copy artifact manifest with durable downloadUrls, suggested project paths, and loader hints for code-project imports.",
"input": {
"asset_type": "model",
"asset_id": "mn785pg330fdx30ty4achjv80985ne5z"
}
},
{
"tool": "get_asset_artifact",
"action": "fetch_artifact_download_url",
"description": "Fetch the chosen artifact to receive mintUrl plus downloadUrl for curl, R3F loaders, browser audio, or game runtime code.",
"input": {
"asset_type": "model",
"asset_id": "mn785pg330fdx30ty4achjv80985ne5z",
"artifact_id": "<artifact_id>"
}
}
]
}Use cases
- Fetch the canonical status and Mint handoff link for a single asset.
- Check the asset's stage to decide whether to wait, revise, or surface output.