> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steadwing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# E2B

> Steadwing connects to E2B to pull sandbox logs, lifecycle events, and resource metrics, helping you diagnose failures in AI applications that use sandboxed code execution.

## What does the E2B integration do?

Steadwing accesses sandbox execution data from your E2B account to diagnose AI application failures. During root cause analysis, Steadwing pulls sandbox logs, lifecycle events, resource metrics, and template configurations to identify why sandboxed code execution failed or degraded.

## Why Use E2B with Steadwing?

<CardGroup cols={2}>
  <Card title="Sandbox Monitoring" icon="box">
    List running and paused sandboxes to understand what was active during an incident
  </Card>

  <Card title="Execution Logs" icon="scroll-text">
    Pull sandbox logs to find execution errors, crashes, and unexpected output
  </Card>

  <Card title="Resource Analysis" icon="cpu">
    Detect CPU, memory, and disk exhaustion that caused sandbox failures
  </Card>

  <Card title="Lifecycle Tracking" icon="rotate-cw">
    Identify unexpected sandbox terminations, timeouts, and state changes
  </Card>
</CardGroup>

## How do I connect E2B to Steadwing?

### Step 1: Get Your E2B API Key

1. Sign up or log in at [e2b.dev](https://e2b.dev)
2. Navigate to the **Dashboard**
3. Go to **Settings** → **API Keys**
4. Copy your existing API key or create a new one

<Warning>
  Store your API key securely. It provides access to your E2B account data including sandbox logs and metrics.
</Warning>

### Step 2: Connect E2B in Steadwing

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **E2B** integration card
3. Click to expand the collapsible form
4. Paste your API key in the **API Key** field
5. Toggle the switch to **Enable** the integration

## What data does Steadwing pull from E2B?

### Data Collection

Steadwing queries E2B for:

* **Sandbox List** - Running, paused, and recently terminated sandboxes and their states
* **Sandbox Logs** - Execution output, error messages, and crash reports from sandbox processes
* **Lifecycle Events** - Sandbox creation, termination, pause/resume events, and timeout triggers
* **Resource Metrics** - CPU, memory, and disk usage to detect resource exhaustion
* **Template Status** - Build status and configuration of sandbox templates
* **Team Metrics** - Concurrent sandbox counts and limit usage across your team

## What permissions does the E2B integration need?

### Required Permissions

The E2B API key requires read access to:

* **Sandboxes** - Read sandbox list, status, and timeout configuration
* **Logs** - Read execution output and error messages
* **Lifecycle** - Read start, stop, pause, resume, and timeout events
* **Resources** - Read CPU, memory, and disk usage metrics
* **Templates** - Read template list, build status, and installed packages
* **Team** - Read concurrent sandbox counts and usage limits

<Tip>
  Steadwing only needs read access to your E2B account. It never creates, modifies, or terminates sandboxes.
</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="What E2B data does Steadwing access?">
    Steadwing reads sandbox states, execution logs, lifecycle events, resource metrics, and template configurations. It does NOT create, modify, or terminate any sandboxes.
  </Accordion>

  <Accordion title="Does E2B require OAuth to connect?">
    No. E2B uses API key authentication — just paste your key in Steadwing Settings and the integration connects immediately. No OAuth redirect required.
  </Accordion>

  <Accordion title="Can Steadwing run code in my sandboxes?">
    No. Steadwing only has read access. It queries sandbox states, logs, and metrics but never executes code or modifies sandbox configurations.
  </Accordion>

  <Accordion title="What if my sandboxes have already terminated?">
    Steadwing can still access logs and lifecycle events for recently terminated sandboxes, subject to E2B's data retention policy.
  </Accordion>

  <Accordion title="What happens if my API key is revoked?">
    The integration will stop working. Simply create a new API key in your E2B dashboard and update it in Steadwing Settings to reconnect.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)