v11

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-023710598.2 KB

Workflows

Estimate per-execution fees for a workflow definition

Returns the platform execution fee, per-node COGS (gas, external API costs), and the workflow-level value-capture fee tier.

post/workflows:estimateFees

Request body

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.

runnerstring

Lowercase or checksummed hex EOA / contract address.

createdAtinteger required

expireAtinteger required

maxExecutioninteger required

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.

Example request

{
  "chainId": 11155111,
  "trigger": {
    "config": {
      "chainId": 11155111
    }
  },
  "nodes": [
    {
      "config": {
        "destination": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
        "chainId": 11155111
      }
    }
  ],
  "runner": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
}

Response

Fee estimate.

chainIdinteger required

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.

pricingModelstring

Pricing model label (e.g., tiered_value_capture_v1).

Example response

{
  "chainId": 11155111,
  "nativeToken": {
    "symbol": "ETH"
  }
}