VARIABLE_TYPE_MISMATCH

HTTP status: 400

What it means

A supplied variable value does not match its declared type.

Why it happens

• A supplied variable value cannot be losslessly coerced to its declared type — e.g. "abc" for a number, a non-http(s) URL for a url, or a value outside an enum's declared values.

How to fix it

• Match the declared type in movie.variables, or change the declaration.
• Coercion is lossless-only: "42" → number works; "soon" does not.

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": "VARIABLE_TYPE_MISMATCH",
    "message": "Variable \"count\" does not match its declared type.",
    "path": "scenes[0].elements[0].text",
    "docsUrl": "https://automotion.dev/docs/errors/variable_type_mismatch"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

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