Create Virtual Environments via API

Use the REST API to create Virtual Environments from scripts, CI/CD jobs, or any backend. The same endpoints back the dashboard. For the full request and response schemas, see the REST API reference.

Before you begin

A Tenderly access key. Export it as TENDERLY_ACCESS_KEY in your shell.
Your account and project slugs, available in the URL of your Tenderly Dashboard.

export TENDERLY_ACCESS_KEY=# the key you copied

Create a single-network Virtual Environment

Create a Multichain Virtual Environment

A Multichain Virtual Environment is created in a single call via the multivnets endpoint. All networks in the call are grouped under one stack_id, which is what makes cross-chain bridging possible between them.

multivnet-create.sh

curl --location 'https://api.tenderly.co/api/v1/account/me/project/project/multivnets' \
  --header 'accept: application/json, text/plain, */*' \
  --header "X-Access-Key: ${TENDERLY_ACCESS_KEY}" \
  --header 'content-type: application/json' \
  --data '{
    "vnets": [
      {
        "slug": "mainnet-staging",
        "fork_config":            { "network_id": 1,     "block_number": "latest" },
        "virtual_network_config": { "chain_config": { "chain_id": 1 } }
      },
      {
        "slug": "arbitrum-staging",
        "fork_config":            { "network_id": 42161, "block_number": "latest" },
        "virtual_network_config": { "chain_config": { "chain_id": 42161 } }
      },
      {
        "slug": "base-staging",
        "fork_config":            { "network_id": 8453,  "block_number": "latest" },
        "virtual_network_config": { "chain_config": { "chain_id": 8453 } }
      }
    ]
  }'

Each entry in the vnets array creates one network inside the Multichain Virtual Environment. The response returns a stack_id and an array of Virtual Environment objects, each with its own RPC endpoints. See the REST API reference for the field-by-field schema.

Next steps

Set up GitHub Actions with Foundry or Hardhat to provision Virtual Environments per pull request.
Stage contracts on the Virtual Environment you just created.
Browse the full REST API reference.

Getting Started

Simulator

Console

Monitor

Node RPC

Account & Settings

Create Virtual Environments via API

Before you begin

Create a single-network Virtual Environment

Create a Multichain Virtual Environment

Next steps

​Before you begin

​Create a single-network Virtual Environment

​Create a Multichain Virtual Environment

​Next steps

Before you begin

Create a single-network Virtual Environment

Create a Multichain Virtual Environment

Next steps