mint:read
Wait For Status
wait_for_status
Briefly waits for a generation to reach a stage, then returns current status, safe moderation categories when available, and retry guidance. timeout_ms is capped at 60000.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- asset_typerequired
"world" | "model" | "asset_pack" | "material" | "material_pack" | "image" | "audio"
- asset_idrequired
string
- timeout_ms
number
- poll_interval_ms
number
- until_stage
"preview" | "final"
- 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",
"until_stage": "preview",
"timeout_ms": 30000,
"poll_interval_ms": 5000
}Example response
{
"assetType": "model",
"assetId": "mn785pg330fdx30ty4achjv80985ne5z",
"type": "model",
"name": "Blush Cloud Loveseat",
"status": "preview_ready",
"assetStage": "preview",
"previewImageUrl": "https://cdn.mint.gg/images/models/blush-cloud-loveseat-preview.webp",
"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>"
}
}
],
"retryAfterMs": null,
"retryGuidance": null,
"failureClass": null,
"failureCode": null,
"failureReason": null,
"moderationCategories": [],
"retryable": false,
"terminal": true,
"reason": "stage_reached",
"workflowStage": "preview_ready",
"workflowStageUpdatedAt": 1745625420000,
"lastHeartbeatAt": 1745625418000
}Use cases
- Wait briefly for a preview before reviewing or approving it.
- Explain a moderation failure using normalized policy labels instead of internal errors.
- Return chatUrl and retry guidance when final generation is still running.