Automotion docs

VARIABLE_UNDECLARED

A {{placeholder}} references a variable that is not declared in movie.variables.

HTTP status: 400

What it means

A {{placeholder}} references a variable that is not declared in movie.variables.

Why it happens

  • The document references {{name}} but movie.variables does not declare name.

How to fix it

  • Declare the variable in the manifest (movie.variables.name = { type: ... }), or remove the reference.
  • To render literal double braces, escape them: {{{{name}}}} renders as {{name}}.

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": "VARIABLE_UNDECLARED",
    "message": "Variable \"username\" is referenced but not declared in \"movie.variables\". Declare it, or escape the braces as {{{{...}}}} for literal text.",
    "path": "scenes[0].elements[0].text",
    "docsUrl": "https://automotion.dev/docs/errors/variable_undeclared"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

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

On this page