ASSET_NOT_FOUND

HTTP status: 422

What it means

A referenced asset URL returned 404 or does not exist.

Why it happens

• An asset URL referenced by the movie answered 404/410 during the prepare phase.

How to fix it

• Verify the URL is publicly reachable (the error path points at the element's src).
• If you uploaded via POST /v1/assets, confirm the PUT upload completed before rendering.

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:

{
  "error": {
    "code": "ASSET_NOT_FOUND",
    "message": "Asset (unknown) could not be found. Check that the URL is publicly reachable.",
    "path": "scenes[0].elements[0].src",
    "docsUrl": "https://automotion.dev/docs/errors/asset_not_found"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

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