Skip to main content

Environment Management

Short answer

Use get_eaas_config as the connectivity check. Use ephemeral_environment (action CONFIG / PROVISION / STATUS) for lifecycle; keep destroy_ephemeral_environment separate. Resolve branch-specific BASE_URL. BunnyShell list/log endpoints return opaque upstream JSON.

Common scenarios​

Ephemeral environment lifecycle​

  1. getEaasConfig to confirm MCP connectivity
  2. ephemeralEnvironment with action=PROVISION (wait defaults true)
  3. Or action=STATUS with bnsEnvironmentId if you provisioned with wait=false
  4. destroyEphemeralEnvironment

Branch endpoint config​

getBranchSpecificEndpointConfig

BunnyShell diagnostics​

listBunnyshellEnvironmentEvents, listBunnyshellWorkflowJobs, getBunnyshellWorkflowJobLogs — free-form upstream payloads.

Frequently asked questions

How do ephemeral environments work via API?

POST /api/mcp/ephemeral_environment with action PROVISION (wait defaults true), then destroy_ephemeral_environment.