Automotion docs

ASSET_FETCH_FAILED

A referenced asset could not be downloaded.

HTTP status: 422

What it means

A referenced asset could not be downloaded.

Why it happens

  • An asset URL could not be downloaded: network failure, timeout, or a non-2xx response.

How to fix it

  • Make the asset publicly fetchable over https and retry.
  • Host large assets on a CDN; slow origins can time out.

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

response.json
{
  "error": {
    "code": "ASSET_FETCH_FAILED",
    "message": "Failed to fetch asset (unknown).",
    "path": "scenes[0].elements[0].src",
    "docsUrl": "https://automotion.dev/docs/errors/asset_fetch_failed"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.

On this page