Effectread-onlyScopemockup:readPlanStarter+
Parameters
handlestringRequired
The task id returned by mockup.generate.
wait_secintegerDefault: 0
0 returns an instant snapshot. Positive values long-poll up to that many seconds and return when the mockups complete/fail or the timeout expires.
Returns
handlestring
status"pending" | "running" | "complete" | "failed"
progressnumber | null
Fractional progress 0.0-1.0 when known.
doneboolean
mockupsobject[]
Each: id, status, external_key, image_url, video_url, error, stage, progress.
urlstring | null
Page that opens these mockups in the app. Share this link rather than building one.