AVavaprotocol
Nodes

Execute a single node with inline input variables

Changed on

Run a non-transaction node against inline variables without persisting a workflow. Contract writes and native transfers, including their loop runners, are rejected. Simulate the complete workflow with its prerequisites using POST /workflows:simulate. Honors node.config.chainId (overrides body chainId). Requires a user Bearer JWT; partner assertion alone is not sufficient.

post/nodes:run

Request

  • Base URL
    https://api.avaprotocol.org/api/v1
  • Auth
    HTTP bearer

Request body

inputVariablesInputVariables

Free-form key-value bag of values used to resolve {{variable.path}} template references inside trigger and node configs. Conventional well-known keys: settings.runner (smart wallet address), settings.chainId (chain id). camelCase keys; back-compat support for snake_case keys exists during the migration window.

chainIdinteger

Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.

Example request

{
  "node": {
    "config": {
      "destination": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
      "chainId": 11155111
    }
  },
  "chainId": 11155111,
  "erc20Overrides": [
    {
      "tokenAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
      "ownerAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
      "spenderAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
    }
  ]
}

Response

Node execution result.

successboolean required
errorstring
errorCodestring
outputunknown
metadataunknown
executionContextunknown

Changes

  • 6b505ebcf3f7Revision changes
    • info

      added the new optional request property ///////

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 4ebf07931311Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status