Skip to main content

List and create

Creation returns an accepted run. Wait for ready before using provider endpoints. get(runId) also exposes progress and failureDetail when available. Treat returned envVars and proxyToken as credentials and do not print them. An unseeded environment starts with empty business data. Seed explicitly with scenarioId, or ask Arga to create starting state:
The default generation mode is fast; a saved scenarioId takes precedence over prompt generation. Plan limits and access rules are enforced by the backend. public: true exposes the returned provider endpoints; choose false when your integration needs proxy-token access.

Manage the run

Reset restores the run’s configured baseline. Lock disables public access. Teardown is asynchronous: inspect get() until the run reaches torn_down. Do not use the ready-state waiter to wait for teardown because ready is itself a terminal result for that waiter. For combined Microsoft environments, microsoftScenarioSnapshot(runId) returns the backend’s Scenario snapshot. The older client.twins.provision helpers remain for compatibility.