source_asset_unavailable
Plugin API error source_asset_unavailable — referenced asset cannot be fetched.
HTTP 422 · not retryable
A source asset referenced by the job (via asset_id or an external URL in external_metadata) could not be downloaded by the worker, or the upload's signed URL has expired before the bytes were PUT.
How to fix
- Re-upload the asset via
POST /assets/uploadand use the newasset_id. - For pre-signed uploads, complete the PUT within the 15-minute TTL.
- If you supplied an external URL, confirm it is reachable from public networks (no VPN, no auth wall).
On a generation failure
The heading above describes this code as a request outcome. When it arrives on a job that was already running, it carries a category, and that is what decides whether anything happens next:
INPUT_MISSING— the input has to come from you. The job is terminal andretryableisfalse.INPUT_NOT_READY— we are still preparing the input ourselves, most often a source photo mid-upscale. The job waits and runs on its own, soretryableistruefor as long as it is waiting. If the preparation never finishes, the wait runs out, the job ends asfailed, andretryablebecomesfalse.
Read retryable as "is another attempt already scheduled". The Error reference page carries the full category table.